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Foreword 



CP/M® 3, also marketed as CP/M Plus 7 " , is a single-console 
operating system for 8-bit machines that use an Intel® 8080, 8085, 
or Zilog® Z80® CPU. CP/M 3 is upward-compatible with its 
predecessor, CP/M 2, and offers more features and higher performance 
than CP/M 2. This manual describes the steps necessary to create or 
modify a CP/M 3 Basic Input Output System (BIOS) tailored for a 
specific hardware environment. 

The CP/M Plus (CP/M Version 3) Operating System System 
Guide assumes you are familiar with systems programming in 8080 
assembly language and that you have access to a CP/M 2 system. It 
also assumes you understand the target hardware and that you have 
functioning disk I/O drivers. You should be familiar with the 
accompanying CP/M Plus (CP/M Version 3) Operating System User's 
Guide describing the operating system utilities. You should also be 
familiar with the CP/M Plus (CP/M Version 3) Operating System 
Programmer's Guide , which describes the system calls used by the 
applications programmer to interface with the operating system. The 
Programmer's Utilities Guide for the CP/M Family of Operating 
Systems documents the assembling and debugging utilities. 

Section 1 of this manual is an overview of the component 
modules of the CP/M 3 operating system. Section 2 provides an 
overview of the functions and data structures necessary to write an 
interface module between CP/M 3 and specific hardware. Section 3 
contains a detailed description of these functions and data 
structures, followed by instructions to assemble and link the 
distributed modules with your customized modules. Section 4 
describes the modular organization of the sample CP/M 3 BIOS on your 
distribution diskette. Section 5 documents the procedure to 
generate and boot your CP/M 3 system. . Section 6 is a sample 
debugging session. 

The appendixes contain tables, and sample BIOS modules you can 
use, or study and modify. Appendix A discusses removable media 
drives. Appendix B discusses automatic density support. Appendix C 
describes how CP/M 3 differs from CP/M 2. Appendix D shows the 
format of the CPM3.SYS file. 

Appendixes E through H are listings of the assembled source 
code for the four hardware-independent modules of the sample BIOS. 
Appendix E is the kernel module to use when creating a modular BIOS 
in the form of the distributed sample. Appendix F shows the System 
Control Block. Appendix G is a table of equates for the baud rate 
and mode byte for character I/O. Appendix H contains the macro 
definitions you can use to generate some of the CP/M 3 disk data 
structures. Appendix I lists the assembled source code for the six 
BIOS modules that depend on the Altos 8000-15 Computer System 
hardware. It also contains a sample Submit file to build a BIOS. 



Appendixes J and K are tabular summaries of the public entry 
points and data items in the modules of the sample BIOS. Finally, 
Appendix L is a tabular summary of the thirty-three functions of the 
CP/M 3 BIOS, complete with entry parameters and returned values. 
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Section 1 
CP/M 3 Operating System Overview 



This section is an overview of the CP/M 3 operating system, 
with a description of the system components and how they relate to 
each other. The section includes a discussion of memory 
configurations and supported hardware. The last portion summarizes 
the creation of a customized version of the CP/M 3 Basic Input 
Output System (BIOS) . 

1.1 Introduction to CP/M 3 

CP/M 3 provides an environment for program development and 
execution on computer systems that use the Intel 8080, 8085, or Z80 
microprocessor chip. CP/M 3 provides rapid access to data and 
programs through a file structure that supports dynamic allocation 
of space for sequential and random access files. 

CP/M 3 supports a maximum of sixteen logical floppy or hard 
disks with a storage capacity of up to 512 megabytes each. The 
maximum file size supported is 32 megabytes. You can configure the 
number of directory entries and block size to satisfy various user 
needs. 

CP/M 3 is supplied in two versions. One version supports 
nonbank-switched memory; the second version supports hardware with 
bank-switched memory capabilities. CP/M 3 supplies additional 
facilities for the bank-switched system, including extended command 
line editing, password protection of files, and extended error 
messages. 

The nonbanked system requires 8.5 kilobytes of memory, plus 
space for your customized BIOS. It can execute in a minimum of 32 
kilobytes of memory. 

The bank-switched system requires a minimum of two memory banks 
with 11 kilobytes of memory in Bank and 1.5 kilobytes in common 
memory, plus space for your customized BIOS. The bank-switched 
system provides more user memory for application programs. 

CP/M 3 resides in the file CPM3.SYS, which is loaded into 
memory by a system loader during system initialization. The system 
loader resides on the first two tracks of the system disk. CPM3.SYS 
contains the distributed BDOS and the customized BIOS. 

The CP/M 3 operating system is distributed on two single- 
density, single-sided, eight-inch floppy disks. Digital Research 
supplies a sample BIOS which is configured for an Altos 8000-15 
microcomputer system with bank-switched memory and two single- 
density, single-sided, eight-inch floppy disk drives. 
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CP/M 3 System Guide 1.2 CP/M 3 System Components 

1.2 CP/M 3 System Components 

The CP/M 3 operating system consists of the following three 
modules: the Console Command Processor (CCP) , the Basic Disk 
Operating System (BDOS) , and the Basic Input Output System (BIOS) . 

The CCP is a program that provides the basic user interface to 
the facilities of the operating system. The CCP supplies six built- 
in commands: DIR, DIRS, ERASE, RENAME, TYPE, and USER. The CCP 
executes in the Transient Program Area (TPA) , the region of memory 
where all application programs execute. The CCP contains the 
Program Loader Module, which loads transient (applications) programs 
from disk into the TPA for execution. 

The BDOS is the logical nucleus and file system of CP/M 3. The 
BDOS provides the interface between the application program and the 
physical input/output routines of the BIOS. 

The BIOS is a hardware-dependent module that interfaces the 
BDOS to a particular hardware environment. The BIOS performs all 
physical I/O in the system. The BIOS consists of a number of 
routines that you must configure to support the specific hardware of 
the target computer system. 

The BDOS and the BIOS modules cooperate to provide the CCP and 
other transient programs with hardware-independent access to CP/M 3 
facilities. Because the BIOS is configured for different hardware 
environments and the BDOS remains constant, you can transfer 
programs that run under CP/M 3 unchanged to systems with different 
hardware configurations. 

1.3 Communication Between Modules 

The BIOS loads the CCP into the TPA at system cold and warm 
start. The CCP moves the Program Loader Module to the top of the 
TPA and uses the Program Loader Module to load transient programs. 

The BDOS contains a set of functions that the CCP and 
applications programs call to perform disk and character input and 
output operations. 

The BIOS contains a Jump Table with a set of 33 entry points 
that the BDOS calls to perform hardware-dependent primitive 
functions, such as peripheral device I/O. For example, CONIN is an 
entry point of the BIOS called by the BDOS to read the next console 
input character . 

Similarities exist between the BDOS functions and the BIOS 
functions, particularly for simple device I/O. For example, when a 
transient program makes a console output function call to the BDOS, 
the BDOS makes a console output call to the BIOS. In the case of 
disk I/O, however, this relationship is more complex. The BDOS 
might make many BIOS function calls to perform a single BDOS file 
I/O function. BDOS disk I/O is in terms of 128-byte logical 
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records. BIOS disk I/O is in terms of physical sectors and tracks. 

The System Control Block (SCB) is a 100-byte decimal CP/M 3 
data structure that resides in the BDOS system component. The BDOS 
and the BIOS communicate through fields in the SCB. The SCB 
contains BDOS flags and data, CCP flags and data, and other system 
information, such as console characteristics and the current date 
and time. You can access some of the System Control Block fields 
from the BIOS. 

Note that the SCB contains critical system parameters which 
reflect the current state of the operating system. If a program 
modifies these parameters, the operating system can crash. See 
Section 3 of this manual, and the description of BDOS Function 49 in 
the CP/M Plus (CP/M Version 3) Operating System Programmer's 
Guide for more information on the System Control Block. 

Page Zero is a region of memory that acts as an interface 
between transient programs and the operating system. Page Zero 
contains critical system parameters, including the entry to the BDOS 
and the entry to the BIOS Warm BOOT routine. At system start-up, 
the BIOS initializes these two entry points in Page Zero. All 
linkage between transient programs and the BDOS is restricted to the 
indirect linkage through Page Zero. Figure 1-1 illustrates the 
general memory organization of CP/M 3. 
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1.3 Communication Between Modules 



0100H: 



0000H: 



BIOS: Basic I/O System 



BDOS: Basic Disk Operating System 



LOADER: Program Loader Module 
Component of CCP 



TPA: Transient Program Area 



CCP: Console Command Processor 



PAGE ZERO 



Figure 1-1. General Memory Organization of CP/M 3 



Note that all memory regions in CP/M 3 are page aligned, which 
means that they must begin on a page boundary. Because a page is 
defined as 256 (100H) bytes, a page boundary always begins at a 
hexadecimal address where the low-order byte of the hex address is 
zero. 



1.4 Banked and Nonbanked Systems 

CP/M 3 is supplied in two versions: one for hardware that 
supports banked memory, and the other for hardware with a minimum of 
32 kilobytes of memory. The systems are called banked and 
nonbanked. 

Digital Research supplies System Page Relocatable (.SPR) files 
for both a banked BDOS and a nonbanked BDOS. A sample banked BIOS 
is supplied for you to use as an example when creating a customized 
BIOS for your set of hardware components. 
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1.4 Banked and Nonbanked Systems 



The following figure shows the memory organization for a banked 
system. Bank and common memory are for the operating system. 
Bank 1 is the Transient Program Area, which contains the Page Zero 
region of memory. You can use additional banks to enhance operating 
system performance. 

In banked CP/M 3 systems, CPMLDR, the system loader, loads part 
of the BDOS into common memory and part of the BDOS into Bank 0. 
CPMLDR loads the BIOS in the same manner . 

Figure 1-2 shows the memory organization for the banked version 
of CP/M 3. 



Top of memory 



Common 
to all banks 



Top of Banked 
Memory 



Bank-Switched 




Hardware-Dependent Buffer Space 
Resident Operating System Modules 




hhhhH 



Bank 



Bank 1 



Bank N 



Figure 1-2. Memory Organization for Banked CP/M 3 System 



In this figure, the top region of memory is called common 
memory. Common memory is always enabled and addressable. The 
operating system is divided into two modules: the resident portion, 
which resides in common memory, and the banked portion, which 
resides just below common memory in Bank 0. 

The shaded areas in Figure 1-2 represent the memory available 
to transient programs. The clear areas are used by the operating 
system for disk record buffers and directory hash tables. The clear 
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1.4 Banked and Nonbanked Systems 



area in the common region above the operating system represents 
space that can be allocated for data buffers by GENCPM, the CP/M 3 
system generation utility. The minimum size of the buffer area is 
determined by the specific hardware requirements of the host 
microcomputer system. 

Bank 0, the system bank, is the bank that is enabled when CP/M 
3 is cold started. Bank 1 is the transient program bank. 

The transient program bank must be contiguous from location 
zero to the top of banked memory. Common memory must also be 
contiguous. The other banks need not begin at location zero or have 
contiguous memory. 

Figure 1-3 shows the CP/M 3 memory organization when the TPA 
bank, Bank 1, is enabled in a bank-switched system. 



Top of memory 



Common 



Top of Banked 
Memory 



Low Memory 
(0000H) 




Hardware Dependent Buffer Space 
Resident Operating System Modules 



Bank 1 



Figure 1-3. Memory Organization with Bank 1 Enabled 
in Banked System 



The operating system switches to Bank or other banks when 
performing operating system functions. In general, any bank 
switching performed by the operating system is transparent to the 
calling program. 

The memory organization for the nonbanked version of CP/M 3 is 
much simpler, as shown in Figure 1-4: 
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1.4 Banked and Nonbanked Systems 



Top of memory 



Low Memory 
(0000H) 




Figure 1-4. Memory Organization in Nonbanked CP/M 3 System 



In the nonbanked version of CP/M 3, memory consists of a single 
contiguous region addressable from 0000H up to a maximum of OFFFFH, 
or 64K-1. The clear area above the operating system represents 
space that can be allocated for data buffers and directory hash 
tables by the CP/M 3 system generation utility, GENCPM, or directly 
allocated by the BIOS. The minimum size of the buffer area is 
determined by the specific hardware requirements of the host 
microcomputer system. Again, the shaded region represents the space 
available for transient programs. 

1.5 Memory Requirements 

Table 1-1 shows typical sizes of the CP/M 3 operating system 
components. 



Table 1-1. CP/M 3 Operating System Memory Requirements 



CP/M 3 Version 



Nonbanked 



Banked 
Common Bank 



BDOS 8.5K 

BIOS (values vary) 

floppy system 1.5K 

hard system 2.5K 



1.5K 



.75K 
1.-5K 



UK 



2K 
3K 



The CP/M 3 banked system requires a minimum of two banks (Bank 
and Bank 1) and can support up to 16 banks of memory. The size of 
the common region is often 16K, but can be as small as 4K. Common 
memory must be large enough to contain the required buffers and the 
resident (common) portion of the operating system, which means a 
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1.5K BDOS and the common part of your customized BIOS. 

In a banked environment, CP/M 3 maintains a cache of deblocking 
buffers and directory records using a Least Recently Used (LRU) 
buffering scheme. The LRU buffer is the first to be reused when the 
system runs out of buffer space. The BDOS maintains separate buffer 
pools for directory and data record caching. 

The RSX modules shown in Figure 1-5 are Resident System 
Extensions (RSX) that are loaded directly below the operating system 
when included in an application or utility program. The Program 
Loader places the RSX in memory and chains BDOS calls through the 
RSX entry point in the RSX. 

Figure 1-5 shows the memory organization in a typical bank- 
switched CP/M 3 system. 



COMMON MEMORY 



ALLOCATION/CHECKSUM 
VECTORS 



BANKED BIOS 3K 



BANKED BDOS UK 



LRU DIRECTORY 
BUFFERS 



HASHED DIRECTORY 

TABLES 
(one per drive) 



BANK 



LRU DATA BUFFERS 



RESIDENT BIOS IK 



RESIDENT BDOS 1.5K 



PROGRAM LOADER 



Stacked RSX Modules 



TPA 



TPA 



Optional overlays 



TRANSIENT PROGRAM 



PAGE ZERO 



LRU DATA BUFFERS 



HASHED DIRECTORY 

TABLES 
(one per drive) 



COPY OF CCP FOR 

WARM START 

(optional) 



BANK 1 



BANK 2 



Figure 1-5. Memory Organization in Banked CP/M 3 
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The banked system supports a TPA of 60K or more. The banked 
portion of the operating system in Bank requires at least 16K of 
memory. 

In the banked system, the BDOS and the BIOS are separated into 
two parts: a resident portion, and a banked portion. The resident 
BDOS and BIOS are located in common memory. The banked BDOS and 
BIOS are located in the operating system bank, referred to as Bank 
in this manual. 

The TPA extends from 100H in Bank 1 up to the bottom of the 
resident BDOS in common memory. The banked BIOS and BDOS reside in 
Bank with the directory buffers. Typically, all data buffers 
reside in common. Data buffers can reside in an alternate bank if 
the system has a DMA controller capable of transferring arbitrary 
blocks of data from one bank to another. Hashed directory tables 
(one per drive) can be placed in any bank except Bank 1 (TPA) . 
Hashed directory tables require 4 bytes per directory entry. 

Figure 1-6 shows a typical nonbanked system configuration. 



Buffers 


and 


Hash 


Tables 


BIOS 


BDOS 


PROGRAM 


LOADER 





Optional overlays 



TRANSIENT PROGRAM 



BASE PAGE Oh - lOOh 



Figure 1-6. Memory Organization in Nonbanked CP/M 3 



The nonbanked CP/M 3 system requires 8.5K of memory plus space 
for the BIOS, buffers, and hash tables, allowing a TPA size of up to 
52K to 54K, depending on the size of the BIOS and the number of hash 
tables and buffers you are using. 
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1.6 Disk Organization 

Figure 1-7 illustrates the organization of a CP/M 3 system 
disk. 



Track M 



Data Tracks 



Track N 



System tracks 



Track 



CP/M 3 Data Region 



CP/M 3 Directory Region 



CCP (Optional) 



CPMLDR 



Cold Boot Loader 



Figure 1-7. CP/M 3 System Disk Organization 



In Figure 1-7, the first N tracks are the system tracks; the 
remaining tracks, the data tracks, are used by CP/M 3 for file 
storage. Note that the system tracks are used by CP/M 3 only during 
system cold start and warm start. All other CP/M 3 disk access is 
directed to the data tracks of the disk. To maintain compatibility 
with Digital Research products, you should use an eight-inch, 
single-density, IBM®3740 formatted disk with two system tracks. 

1.7 Hardware Supported 

You can customize the BIOS to match any hardware environment 
with the following general characteristics. 



All Information Presented Here is Proprietary to Digital Research 

10 



CP/M 3 System Guide 1.7 Hardware Supported 

1.7.1 Hardware Supported by CP/M 3 Banked System 

• Intel 8080, Intel 8085, or Zilog Z80 CPU or equivalent. 

o A minimum of two and up to sixteen banks of memory with the top 
4K-32K in common memory. Bank 1 must have contiguous memory 
from address 0000H to the base of common memory. A reasonable 
configuration consists of two banks of 48K RAM each, with the 
top 16K in common memory. 

• One to sixteen disk drives of up to 512 megabytes capacity 
each. 

• Some form of ASCII console device, usually a CRT. 

• One to twelve additional character input and or output devices, 
such as printers, communications hardware, and plotters. 

1.7.2 Hardware Supported by CP/H 3 Nonbanked System 

• Intel 8080, Intel 8085, or Zilog Z80 CPU or equivalent. 

• A minimum of 32K and up to 64K contiguous memory addressable 
from location zero. 

• One to sixteen disk drives of up to 512 megabytes capacity 
each. 

• Some form of ASCII console device, usually a CRT. 

• One to twelve additional input and or output devices, usually 
including a printer. 

Because most CP/M-compatible software is distributed on eight- 
inch, soft-sectored, single-density floppy disks, it is recommended 
that a CP/M 3 hardware configuration include a minimum of two disk 
drives, at least one of which is a single-density floppy disk drive. 

1.8 Customizing CP/M 3 

Digital Research supplies the BDOS files for a banked and a 
nonbanked version of CP/M 3. A system generation utility, GENCPM, 
is provided with CP/M 3 to create a version of the operating system 
tailored to your hardware. GENCPM combines the BDOS and your 
customized BIOS files to create a CPM3.SYS file, which is loaded 
into memory at system start-up. The CPM3.SYS file contains the BDOS 
and BIOS system components and information indicating where these 
modules reside in memory. 

Digital Research supplies a CP/M 3 loader file, CPMLDR, which 
you can link with your customized loader BIOS and use to load the 
CPM3.SYS file into memory. CPMLDR is a small, self-contained 
version of CP/M 3 that supports only console output and sequential 
file input. Consistent with CP/M 3 organization, it contains two 
modules: an invariant CPMLDR_BDOS, and a variant CPMLDR_BIOS, which 
is adapted to match the host microcomputer hardware environment. 
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The CPMLDR_BIOS module can perform cold start initialization of I/O 
ports and similar functions. CPMLDR can display a memory map of the 
CP/M 3 system at start-up. This is a GENCPM option. 

The following steps tell you how to create a new version of 
CP/M 3 tailored to your specific hardware. 

1) Write and assemble a customized BIOS following the 
specifications described in Section 3. This software 
module must correspond to the exact physical 
characteristics of the target system, including memory and 
port addresses, peripheral types, and drive 
characteristics. 

2) Use the system generation utility, GENCPM, to create the 
CPM3.SYS file containing the CP/M 3 distributed BDOS and 
your customized BIOS, as described in Section 5. 

3) Write a customized loader BIOS (LDRBIOS) to reside on the 
system tracks as part of CPMLDR. CPMLDR loads the CPM3.SYS 
file into memory from disk. Section 5 gives the 
instructions for customizing the LDRBIOS and generating 
CPMLDR. Link your customized LDRBIOS file with the 
supplied CPMLDR file. 

4) Use the COPYSYS utility to put CPMLDR on the system tracks 
of a disk. 

5) Test and debug your customized version of CP/M 3. 

If you have banked memory, Digital Research recommends that you 
first use your customized BIOS to create a nonbanked version of the 
CP/M 3 operating system. You can leave your entire BIOS in common 
memory until you have a working system. Test all your routines in a 
nonbanked version of CP/M 3 before you create a banked version. 

1.9 Initial Load (Cold Boot) of CP/M 3 

CP/M 3 is loaded into memory as follows. Execution is 
initiated by a four-stage procedure. The first stage consists of 
loading into memory a small program, called the Cold Boot Loader, 
from the system tracks of the Boot disk. This load operation is 
typically handled by a hardware feature associated with system 
reset. The Cold Boot Loader is usually 128. or 256 bytes in .length. 

In the second stage, the Cold Boot Loader loads the memory 
image of the CP/M 3 system loader program, CPMLDR, from the system 
tracks of a disk into memory and passes control to it. For a banked 
system, the Cold Boot Loader loads CPMLDR into Bank 0. A PROM 
loader can perform stages one and two. 
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In the third stage, CPMLDR reads the CPM3.SYS file, which 
contains the BDOS and customized BIOS, from the the data area of the 
disk into the memory addresses assigned by GENCPM. In a banked 
system, CPMLDR reads the common part of the BDOS and BIOS into the 
common part of memory, and reads the banked part of the BDOS and 
BIOS into the area of memory below common_base in Bank 0. CPMLDR 
then transfers control to the Cold BOOT system initialization 
routine in the BIOS. 

For the final stage, the BIOS Cold BOOT routine, BIOS Function 
0, performs any remaining necessary hardware initialization, 
displays the sign-on message, and reads the CCP from the system 
tracks or from a CCP.COM file on disk into location 100H of the TPA. 
The Cold BOOT routine transfers control to the CCP, which then 
displays the system prompt. 

Section 2 provides an overview of the organization of the 
System Control Block and the data structures and functions in the 
CP/M 3 BIOS. 

End of Section 1 
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Section 2 
CP/M 3 BIOS Overview 



This section describes the organization of the CP/M 3 BIOS and 
the BIOS jump vector. It provides an overview of the System Control 
Block, followed by a discussion of system initialization procedures, 
character I/O, clock support, disk I/O, and memory selects and 
moves. 



2.1 Organization of the BIOS 

The BIOS is the CP/M 3 module that contains all hardware- 
dependent input and output routines. To configure CP/M 3 for a 
particular hardware environment, use the sample BIOS supplied with 
this document and adapt it to the specific hardware of the target 
system. 

Alternatively, you can modify an existing CP/M 2.2 BIOS to 
install CP/M 3 on your target machine. Note that an unmodified CP/M 

2.2 BIOS does not work with the CP/M 3 operating system. See 
Appendix C for a description of the modifications necessary to 
convert a CP/M 2.2 BIOS to a CP/M 3 BIOS. 

The BIOS is a set of routines that performs system 
initialization, character-oriented I/O to the console and printer 
devices, and physical sector I/O to the disk devices. The BIOS also 
contains routines that manage block moves and memory selects for 
systems with bank-switched memory. The BIOS supplies tables that 
define the layout of the disk devices and allocate buffer space 
which the BDOS uses to perform record blocking and deblocking. The 
BIOS can maintain the system time and date in the System Control 
Block. 

Table 2-1 describes the entry points into the BIOS from the 
Cold Start Loader and the BDOS. Entry to the BIOS is through a jump 
vector. The jump vector is a set of 33 jump instructions that pass 
program control to the individual BIOS subroutines. 

You must include all of the entry points in the BIOS jump 
vector in your BIOS. However, if your system does not support some 
of the functions provided for in the BIOS, you can use empty 
subroutines for those functions. For example, if your system does 
not support a printer, JMP LIST can reference a subroutine 
consisting of only a RET instruction. Table 2-1 shows the elements 
of the jump vector. 
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Table 2-1. CP/M 3 BIOS Jump Vector 



No. Instruction 



Description 





1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 



JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 
JMP 



BOOT 

WBOOT 

CONST 

CONIN 

CONOUT 

LIST 

AUXOUT 

AUXIN 

HOME 

SELDSK 

SETTRK 

SETSEC 

SETDMA 

READ 

WRITE 

LISTST 

SECTRN 

CONOST 

AUXIST 

AUXOST 

DEVTBL 

DEVINI 

DRVTBL 

MULT 10 



24 JMP FLUSH 



25 


JMP 


MOVE 


26 


JMP 


TIME 


27 


JMP 


SELMEM 


28 


JMP 


SETBNK 


29 


JMP 


XMOVE 


30 


JMP 


USERF 


31 


JMP 


RESERV1 


32 


JMP 


RESERV2 



Perform cold start initialization 

Perform warm start initialization 

Check for console input character ready 

Read Console Character in 

Write Console Character out 

Write List Character out 

Write Auxiliary Output Character 

Read Auxiliary Input Character 

Move to Track 00 on Selected Disk 

Select Disk Drive 

Set Track Number 

Set Sector Number 

Set DMA Address 

Read Specified Sector 

Write Specified Sector 

Return List Status 

Translate Logical to Physical Sector 

Return Output Status of Console 

Return Input Status of Aux. Port 

Return Output Status of Aux. Port 

Return Address of Char. I/O Table 

Initialize Char. I/O Devices 

Return Address of Disk Drive Table 

Set Number of Logically Consecutive 

sectors to be read or written 

Force Physical Buffer Flushing for 

user-supported deblocking 

Memory to Memory Move 

Time Set/Get signal 

Select Bank of Memory 

Specify Bank for DMA Operation 

Set Bank When a Buffer is in a Bank 

other than or 1 

Reserved for System Implementor 

Reserved for Future Use 

Reserved for Future Use 



Each jump address in Table 2-1 corresponds to a particular 
subroutine that performs a specific system operation. Note that two 
entry points are reserved for future versions of CP/M, and one entry 
point is provided for OEM subroutines, accessed only by direct BIOS 
calls using BDOS Function 50. Table 2-2 shows the five categories 
of system operations and the function calls that accomplish these 
operations. 
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Table 2-2. CP/M 3 BIOS Functions 



Operation 


Function 


System Initialization 




BOOT, WBOOT, DEVTBL, DEVINI, DRVTBL 


Character I/O 






CONST, CONIN, CONOUT, LIST, AUXOUT, AUXIN, 




LISTST, CONOST, AUXIST, AUXOST 


Disk I/O 






HOME, SELDSK, SETTRK, SETSEC, SETDMA, 




READ, WRITE, SECTRN, MULTIO, FLUSH 


Memory Selects 


and Moves 




MOVE, SELMEM, SETBNK, XMOVE 


Clock Support 






TIME 



You do not need to implement every function in the BIOS jump 
vector. However, to operate, the BDOS needs the BOOT, WBOOT, CONST, 
CONIN, CONOUT, HOME, SELDSK, SETTRK, SETSEC, SETDMA, READ, WRITE, 
SECTRN, MULTIO, FLUSH, and TIME subroutines. Implement SELMEM and 
SETBNK only in a banked environment. You can implement MULTIO and 
FLUSH as returns with a zero in Register A. DEVICE and some other 
utilities use the remaining entry points, but it is not necessary to 
fully implement them in order to debug and develop the system. 

Note: include all routines but make the nonimplemented routines a 
RET instruction. 



2.2 System Control Block 

The System Control Block (SCB) is a data structure located in 
the BDOS. The SCB is a communications area referenced by the BDOS, 
the CCP, the BIOS, and other system components. The SCB contains 
system parameters and variables, some of which the BIOS an 
reference. The fields of the SCB are named, and definitions of 
these names are supplied as public variable and subroutine names in 
the SCB. ASM file contained on the distribution disk. See Section 
3.1 for a discussion of the System Control Block. 
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2.3 System Initialization 

When the BOOT and WBOOT routines of the BIOS get control, they 
must initialize two system parameters in Page Zero of memory, as 
shown in Table 2-3. 



Table 2-3. Initialization of Page Zero 



Location 



Description 



0,1,2 Set to JMP WBOOT (0000H: JMP BIOS+3) . Location 
1 and 2 must contain the address of WBOOT in 
the jump vector. 

5,6,7 Set to JMP BDOS, the primary entry point to 
CP/M 3 for transient programs. The current 
address of the BDOS is maintained in the 
variable @MXTPA in the System Control Block. 
(See Section 3.1, System Control Block, and 
Section 3.4.1, BIOS Function 1: WBOOT.) 



The BOOT and WBOOT routine must load the CCP into the TPA in 
Bank 1 at location 0100H. The CCP can be loaded in two ways. If 
there is sufficient space on the system tracks, the CCP can be 
stored on the system tracks and loaded from there. If you prefer, 
or if there is not sufficient space on the system tracks, the BIOS 
Cold BOOT routine can read the CCP into memory from the file CCP.COM 
on disk. 

If the CCP is in a .COM file, use the BOOT and WBOOT routines 
to perform any necessary system initialization, then use the BDOS 
functions to OPEN and READ the CCP.COM file into the TPA. In bank- 
switched systems, the CCP must be read into the TPA in Bank 1. 

In bank-switched systems, your Cold BOOT routine can place a 
copy of the CCP into a reserved area of an alternate bank after 
loading the CCP into the TPA in Bank 1. Then the Warm BOOT routine 
can copy the CCP into the TPA in Bank 1 from the alternate bank, 
rather than reloading the CCP from disk, thus avoiding all disk 
accesses during warm starts. 

There is a 128-byte buffer in the resident portion of the BDOS 
in a banked system that can be used by BOOT and WBOOT. The address 
of this buffer is stored in the SCB variable @BNKBF. BOOT and WBOOT 
can use this buffer when copying the CCP to and from the alternate 
bank. 

The system tracks for CP/M 3 are usually partitioned as shown 
in the following figure: 
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Cold 
Start Ldr 



CPMLDR 



CCP 
(optional) 



Figure 2-1. CP/M 3 System Tracks 



The cold start procedure is designed so you need to initialize 
the system tracks only once. This is possible because the system 
tracks contain the system loader and need not change when you change 
the CP/M 3 operating system. The Cold Start Loader loads CPMLDR 
into a constant memory location that is chosen when the system is 
configured. However, CPMLDR loads the BDOS and BIOS system 
components into memory as specified in the CPM3.SYS file generated 
by GENCPM, the system generation utility. Thus, CP/M 3 allows the 
user to configure a new system with GENCPM and then run it without 
having to update the system tracks of the system disk. 

2.4 Character I/O 

CP/M 3 assumes that all simple character I/O operations are 
performed in 8-bit ASCII, upper- and lower-case, with no parity. An 
ASCII CRTL-Z (1AH) denotes, an end-of-file condition for an input 
device. 

Table 2-4 lists the characteristics of the logical devices. 



Table 2-4. CP/M 3 Logical Device Characteristics 



Device 



Characteristics 



CONIN, CONOUT 



LIST 



AUXOUT 



AUXIN 



The interactive console that 
communicates with the operator, 
accessed by CONST, CONIN, CONOUT, and 
CONOUTST. Typically, the CONSOLE is a 
device such as a CRT or teletype, 
interfaced serially, but it can also 
be a memory-mapped video display and 
keyboard. The console is an input 
device and an output device. 

The system printer, if it exists on 
your system. LIST is usually a hard- 
copy device such as a printer or 
teletypewriter. 

The auxiliary character output device, 
such as a modem. 

The auxiliary character input device, 
such as a modem. 
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Note that you can define a single peripheral as the LIST, 
AUXOUT, and AUXIN device simultaneously. If you assign no 
peripheral device as the LIST, AUXOUT, or AUXIN device, the AUXOUT 
and LIST routines can just return, and the AUXIN routine can return 
with a 1AH (CTRL-Z) in register A to indicate an immediate end-of- 
file. 

CP/M 3 supports character device I/O redirection. This means 
that you can direct a logical device, such as CONIN or AUXOUT, to 
one or more physical devices. The DEVICE utility allows you to 
reassign devices and display and change the current device 
configurations, as described in the CP/M 3 User's Guide. The I/O 
redirection facility is optional. You should not implement it until 
the rest of your BIOS is fully functional. 

2.5 Disk I/O 

The BDOS accomplishes disk I/O by making a sequence of calls to 
the various disk access subroutines in the BIOS. The subroutines 
set up the disk number to access, the track and sector on a 
particular disk, and the Direct Memory Access (DMA) address and bank 
involved in the I/O operation. After these parameters are 
established, the BDOS calls the READ or WRITE function to perform 
the actual I/O operation. 

Note that the BDOS can make a single call to SELDSK to select a 
disk drive, follow it with a number of read or write operations to 
the selected disk, and then select another drive for subsequent 
operations. 

CP/M 3 supports multiple sector read or write operations to 
optimize rotational latency on block disk transfers. You can 
implement the multiple sector I/O facility in the BIOS by using the 
multisector count passed to the MULTIO entry point. The BDOS calls 
MULTIO to read or write up to 128 sectors. For every sector number 
1 to n, the BDOS calls SETDMA then calls READ or WRITE. 

Table 2-5 shows the sequence of BIOS calls that the BDOS makes 
to read or write a physical disk sector in a nonbanked and a banked 
system. Table 2-6 shows the sequence of calls the BDOS makes to the 
BIOS to read or write multiple contiguous physical sectors in a 
nonbanked and banked system. 
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Table 2-5. BDOS Calls to BIOS in Nonbanked and Banked Systems 



Nonbanked BDOS 


Call 


Explanation 


SELDSK 


Called only when disk is 
selected or reselected. 


initially 


SETTRK 


Called for every 
physical sector. 


read or 


write 


of 


a 


SETSEC 


Called for every 
physical sector. 


read or 


write 


of 


a 


SETDMA 


Called for every 
physical sector. 


read or 


write 


of 


a 


READ, WRITE 


Called for every 
physical sector. 


read or 


write 


of 


a 


Banked BDOS 


Call 


Explanation 


SELDSK 


Called only when disk is 
selected or reselected. 


init 


ial 


iy 


SETTRK 


Called for every 
physical sector. 


read or 


write 


of 


a 


SETSEC 


Called for every 
physical sector . 


read or 


write 


of 


a 


SETDMA 


Called for every 
physical sector. 


read or 


write 


of 


a 


SETBNK 


Called for every 
physical sector. 


read or 


write 


of 


a 


READ, WRITE 


Called for every 
physical sector . 


read or 


write 


of 


a 
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Table 2-6. Multiple Sector I/O in Nonbanked and Banked Systems 



Nonbanked BDOS 


Call 


Explanation 


SELDSK 


Called only when disk 
selected or reselected. 


> is 


> initially 


MULTIO 


Called to inform the BIOS that the next n 
calls to disk READ or disk WRITE require a 
transfer of n contiguous physical sectors 
to contiguous memory. 


SETTRK 


Called for every 
physical sector. 


read 


or 


write of a 


SETSEC 


Called for every 
physical sector. 


read 


or 


write of a 


SETDMA 


Called for every 
physical sector. 


read 


or 


write of a 


READ, WRITE 


Called for every 
physical sector. 


read 


or 


write of a 


SELDSK 


Called only when disk 
selected or reselected. 


is 


initially 


MULTIO 


Called to inform the BIOS that the next n 
calls to disk READ or disk WRITE require a 
transfer of n contiguous physical sectors 
to contiguous memory. 


SETTRK 


Called for every 
physical sector. 


read 


or 


write of a 


SETSEC 


Called for every 
physical sector . 


read 


or 


write of a 


SETDMA 


Called for every 
physical sector. 


read 


or 


write of a 


SETBNK 


Called for every 
physical sector. 


read 


or 


write of a 


READ, WRITE 


Called for every 
physical sector. 


read 


or 


write of a 
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Table 2-7 shows the sequence of BDOS calls to read two 
contiguous physical sectors in a banked system. 

Table 2-7. Reading Two Contiguous Sectors in Banked System 



Call 


Explanation 


SELDSK 


Called to initially select disk 


MULT 10 


With a value of 2 


SETTRK 


For first sector 


SETSEC 


For first sector 


SETDMA 


For first sector 


SETBNK 




READ 




SETTRK 


For second sector 


SETSEC 


For second sector 


SETDMA 


For second sector 


SETBNK 




READ 





The CP/M 3 BDOS performs its own blocking and deblocking of 
logical 128-byte records. Unlike earlier versions of CP/M, the BIOS 
READ and WRITE routines always transfer physical sectors as 
specified in the Disk Parameter Block to or from the DMA buffer. 
The Disk Parameter Header defines one or more physical sector 
buffers which the BDOS uses for logical record blocking and 
deblocking. 

In a banked environment, CP/M 3 maintains a cache of deblocking 
buffers and directory records using a Least Recently Used (LRU) 
buffering scheme. The LRU buffer is the first to be reused when the 
system runs out of buffer space. The BDOS maintains separate buffer 
pools for directory and data record caching. 

The BIOS contains the data structures to control the data and 
directory buffers and the hash tables. You can either assign these 
buffers and tables yourself in the BIOS, or allow the GENCPM utility 
to generate them automatically. 

Hash tables greatly speed directory searching. The BDOS can 
use hash tables to determine the location of directory entries and 
therefore reduce the number of disk accesses required to read a 
directory entry. The hash table allows the BDOS to directly access 
the sector of the directory containing the desired directory entry 
without having to read the directory sequentially. By eliminating a 
sequential read of the directory records, hashing also increases the 
percentage of time that the desired directory record is in a buffer, 
eliminating the need for any physical disk accesses in these cases. 
Hash tables and directory caches eliminate many of the directory 
accesses required when accessing large files. However, in a 
nonbanked system, hash tables increase the size of the operating 
system. 
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When the BIOS finds an error condition, the READ and WRITE 
routines should perform several retries before reporting the error 
condition to the BDOS. Ten retries are typical. If the BIOS 
returns an error condition to the BDOS, the BDOS reports the error 
to the user in the following form: 

CP/M Error on d: Disk I/O 

where d: represents the drive specification of the relevant drive. 

To provide better diagnostic capabilities for the user, it is 
often desirable to print a more explicit error message from the BIOS 
READ or WRITE routines before the BIOS returns an error code to the 
BDOS. The BIOS should interrogate the SCB Error Mode Variable to 
determine if it is appropriate to print a message on the console. 

2.6 Memory Selects and Moves 

Four BIOS functions are provided to perform memory management. 
The functions are MOVE, XMOVE, SELMEM, and SETBNK. The XMOVE, 
SELMEM, and SETBNK memory management routines are applicable to the 
BIOS of banked systems. 

The BDOS uses the BIOS MOVE routine to perform memory-to-memory 
block transfers. In a banked system, the BDOS calls XMOVE to 
specify the source and destination banks to be used by the MOVE 
routine. If you use memory that is not in the common area for data 
record buffers, you must implement the XMOVE routine. 

The BDOS uses SELMEM when the operating system needs to execute 
code or access data in other than the currently selected bank. 

The BDOS calls the SETBNK routine prior to calling disk READ or 
disk WRITE functions. The SETBNK routine must save its specified 
bank as the DMA bank. When the BDOS invokes a disk I/O routine, the 
I/O routine should save the current bank number and select the DMA 
bank prior to the disk READ or WRITE. After completion of the disk 
READ or WRITE, the disk I/O routine must reselect the current bank. 
Note that when the BDOS calls the disk I/O routines, Bank is in 
context (selected) . 

2.7 Clock Support 

If the system has a real-time clock or is capable of -keeping 
time, possibly by counting interrupts from a counter/timer chip, 
then the BIOS can maintain the time of day in the System Control 
Block and update the time on clock interrupts. BIOS Function 26 is 
provided for those systems where the clock is unable to generate an 
interrupt. 
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The time of day is kept as four fields. @DATE is a binary word 
containing the number of days since January 1, 1978. The bytes 
OHOUR, @MIN, and @SEC in the System Control Block contain the hour, 
minute, and second in Binary Coded Decimal (BCD) format. 

End of Section 2 
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Section 3 
CP/M 3 BIOS Functional Specifications 



This section contains a detailed description of the CP/M 3 
BIOS. The section first discusses the BIOS data structures and 
their relationships, including the System Control Block, the drive 
table, the Disk Parameter Header, the Disk Parameter Block, the 
Buffer Control Blocks, and the character I/O table. The overview of 
the data structures is followed by a summary of the functions in the 
BIOS jump vector. A detailed description of the entry values and 
returned values for each jump instruction in the BIOS jump vector 
follows the summary. The last part of this section discusses the 
steps to follow when assembling and linking your customized BIOS. 

3.1 The System Control Block 

The System Control Block (SCB) is a data structure located in 
the BDOS. The SCB contains flags and data used by the CCP, the 
BDOS, the BIOS, and other system components. The BIOS can access 
specific data in the System Control Block through the public 
variables defined in the SCB. ASM file, which is supplied on the 
distribution disk. 

Declare the variable names you want to reference in the SCB as 
externals in your BIOS. ASM source file. Then link your BIOS with 
the SCB.REL module. 

In the SCB. ASM file, the high-order byte of the various SCB 
addresses is defined as OFEH. The linker marks absolute external 
equates as page relocatable when generating a System Page 
Relocatable (SPR) format file. GENCPM recognizes page relocatable 
addresses of OFExxH as references to the System Control Block in the 
BDOS. GENCPM changes these addresses to point to the actual SCB in 
the BDOS when it is relocating the system. 

Do not perform assembly- time arithmetic on any references to 
the external labels of the SCB. The result of the arithmetic could 
alter the page value to something other than OFEH. 

Listing 3-1 shows the SCB. ASM file. The listing shows the 
field names of the System Control Block. A @ before a name 
indicates that it is a data item. A ? preceding a name indicates 
that it is the label of an instruction. In the listing, r/w means 
Read-Write, and r/o means Read-Only. The BIOS can modify a Read- 
Write variable, but must not modify a Read-Only variable. Table 3-1 
describes each item in the System Control Block in detail. 
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3.1 The System Control Block 



title 'System Control Block Definition for CP/M3 BIOS* 

public @civec, @covec, Qaivec, @aovec, @lovec, @bnkbf 
public @crdma, @crdsk, @vinfo, @resel, @fx, @usrcd 
public @mltio, @ermde, @erdsk, @media, @bflgs 
public @date, @hour, @min, @sec, Perjmp, @mxtpa 



scb$base equ 

@CIVEC equ 

@COVEC equ 

@AIVEC equ 

@AOVEC equ 

@LOVEC equ 

@BNKBF equ 

@CRDMA equ 

@CRDSK equ 

@VINFO equ 

@RESEL equ 

@FX equ 

@USRCD equ 

@MLTIO equ 

@ERMDE equ 

@ERDSK equ 

@MEDIA equ 

@BFLGS equ 

@DATE equ 

@HOUR equ 

@MIN equ 

@SEC equ 

PERJMP equ 

@MXTPA equ 

end 



0FE00H 

scb$base+22h 

scb$base+24h 

scb$base+26h 

scb$base+28h 

scb$base+2Ah 

scb$base+35h 

scb$base+3Ch 

scb$base+3Eh 
scb$base+3Fh 

scb$base+41h 
scb$base+43h 

scb$base+44h 
scb$base+4Ah 

scb$base+4Bh 
scb$base+51h 
scb$base+54h 

scb$base+57h 

scb$base+58h 

scb$base+5Ah 
scb$base+5Bh 
scb$base+5Ch 
scb$base+5Fh 

scb$base+62h 



Base of the SCB 

Console Input Redirection 
Vector (word, r/w) 
Console Output Redirection 
Vector (word, r/w) 
Auxiliary Input Redirection 
Vector (word, r/w) 
Auxiliary Output Redirection 
Vector (word, r/w) 
List Output Redirection 
Vector (word, r/w) 
Address of 128 Byte Buffer 
for Banked BIOS (word, r/o) 
Current DMA Address 
(word, r/o) 

Current Disk (byte, r/o) 
BDOS Variable "INFO" 
(word, r/o) 
FCB Flag (byte, r/o) 
BDOS Function for Error 
Messages (byte, r/o) 
Current User Code (byte, r/o) 
Current Multisector Count 
(byte, r/w) 

BDOS Error Mode (byte, r/o) 
BDOS Error Disk (byte, r/o) 
Set by BIOS to indicate 
open door (byte, r/w) 
BDOS Message Size Flag 
(byte, r/o) 

Date in Days Since 1 Jan 78 
(word, r/w) 

Hour in BCD (byte, r/w) 
Minute in BCD (byte, r/w) 
Second in BCD (byte, r/w) 
BDOS Error Message Jump 
(3 bytes, r/w) 
Top of User TPA 
(address at 6,7) (word, r/o) 



Listing 3-1. The SCB. ASM File 
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The following table describes in detail each of the fields of 
the System Control Block. 



Table 3-1. System Control Block Fields 



Field 



Meaning 



@CIVEC, @COVEC, @AIVEC, @AOVEC, OLOVEC (Read-Write 
Variable) 

These fields are the 16 bit I/O redirection 
vectors for the five logical devices: console 
input, console output, auxiliary input, 
auxiliary output, and the list device. (See 
Section 3.4.2, Character I/O Functions.) 



@BNKBF (Read-Only Variable) 



QBNKBF contains the address of a 128 byte 
buffer in the resident portion of the BDOS in a 
banked system. This buffer is available for 
use during BOOT and WBOOT only. You can use it 
to transfer a copy of the CCP from an image in 
an alternate bank if the system does not 
support interbank moves. 



@CRDMA, @FX, @USRCD, QERDSK (Read-Only Variable) 

These variables contain the current DMA 
address, the BDOS function number, the current 
user code, and the disk code of the drive on 
which the last error occurred. They can be 
displayed when a BDOS error is intercepted by 
the BIOS. See ?ERJMP. 



@CRDSK (Read-Only Variable) 



@CRDSK is the current default drive, set by 
BDOS Function 14. 



QVINFO, @RESEL (Read-Only Variable) 

If @RESEL is equal to OFFH then @VINFO contains 
the address of a valid FCB. If @RESEL is not 
equal to OFFH, then §VINFO is undefined. You 
can use @VINFO to display the f ilespec when the 
BIOS intercepts a BDOS error. 
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Table 3-1. (continued) 



Field 



Meaning 



@MLTIO (Read-Write Variable) 

@MLTIO contains the current multisector count. 
The BIOS can change the multisector count 
directly, or through BDOS Function 44. The 
value of the multisector count can range from 1 
to 128. 



@ERMDE (Read-Only Variable) 



@ERMDE contains the current BDOS error mode. 
OFFH indicates the BDOS is returning error 
codes to the application program without 
displaying any error messages. OFEH indicates 
the BDOS is both displaying and returning 
errors. Any other value indicates the BDOS is 
displaying errors without notifying the 
application program. 



@MEDIA (Read-Write Variable) 

@MEDIA is global system flag indicating that a 
drive door has been opened. The BIOS routine 
that detects the open drive door sets this flag 
to OFFH. The BIOS routine also sets the MEDIA 
byte in the Disk Parameter Header associated 
with the open-door drive to OFFH. 



@BFLGS (Read-Only Variable) 



The BDOS in CP/M 3 produces two kinds of error 
messages: short error messages and extended 
error messages. Short error messages display 
one or two lines of text. Long error messages 
display a third line of text containing the 
filename, filetype, and BDOS Function Number 
involved in the error. 

In banked systems, GENCPM sets this flag in the 
System Control Block to indicate whether the 
BIOS displays short or extended error messages. 
Your error message handler should check this 
byte in the System Control Block. If the high- 
order bit, bit 7, is set to 0, the BDOS 
displays short error messages. If the high- 
order bit is set to 1, the BDOS displays the 
extended three-line error messages. 
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Table 3-1. (continued) 



Field 



Meaning 



@BFLGS (continued) 



For example, the BDOS displays the following 
error message if the BIOS returns an error from 
READ and the BDOS is displaying long error 
messages. 

CP/M Error on d: Disk I/O 

BDOS Function = nn File = filename. typ 

In the above error message, Function nn and 
filename, typ represent BDOS function number and 
file specification involved, respectively. 



@DATE (Read-Write Variable) 



The number of days since 1 January 1978, 
expressed as a 16-bit unsigned integer, low 
byte first. A real-time clock interrupt can 
update the QDATE field to indicate the current 
date. 



@HOUR, @MIN, @SEC (Read-Write Variable) 

These 2-digit Binary Coded Decimal (BCD) fields 
indicate the current hour, minute, and second 
if updated by a real-time clock interrupt. 



PERJMP (Read-Write Code Label) 

The BDOS calls the error message subroutine 
through this jump instruction. Register C 
contains an error code as follows: 

1 Permanent Error 

2 Read Only Disk 

3 Read Only File 

4 Select Error 

7 Password Error 

8 File Exists 

9 ? in Filename 

Error code 1 above results in the BDOS message 
Disk I/O. 



All Information Presented Here is Proprietary to Digital Research 

31 



CP/M 3 System Guide 



3.1 The System Control Block 



Table 3-1. (continued) 



Field 



Meaning 



7ERJMP (continued) 



The 7ERJMP vector allows the BIOS to intercept 
the BDOS error messages so you can display them 
in a foreign language. Note that this vector 
is not branched to if the application program 
is expecting return codes on physical errors. 
Refer to the CP/M 3 Programmer's Guide for 
more information. 

PERJMP is set to point to the default (English) 
error message routine contained in the BDOS. 
The BOOT routine can modify the address at 
7ERJMP+1 to point to an alternate message 
routine. Your error message handler can refer 
to @FX, @VINFO (if @RESEL is equal to OFFH) , 
@CRDMA, @CRDSK, and @USRCD to print additional 
error information. Your error handler should 
return to the BDOS with a RET instruction after 
printing the appropriate message. 



@MXTPA (Read-Only Variable) 



@MXTPA contains the address of the current BDOS 
entry point. This is also the address of the 
top of the TPA. The BOOT and WBOOT routines of 
the BIOS must use this address to initialize 
the BDOS entry JMP instruction at location 
005H, during system initialization. Each time 
a RSX is loaded, @MXTPA is adjusted by the 
system to reflect the change in the available 
User Memory (TPA) . 



3.2 Character I/O Data Structures 

The BIOS data structure CHRTBL is a character table describing 
the physical I/O devices. CHRTBL contains 6-byte physical device 
names and the characteristics of each physical device. These 
characteristics include a mode byte, and the current baud rate, if 
any, of the device. The DEVICE utility references the physical 
devices through the names and attributes contained in your CHRTBL. 
DEVICE can also display the physical names and characteristics in 
your CHRTBL. 

The mode byte specifies whether the device is an input or 
output device, whether it has a selectable baud rate, whether it is 
a serial device, and if XON/XOFF protocol is enabled. 
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Listing 3-2 shows a sample character device table that the 
DEVICE utility uses to set and display I/O direction. 



; sample character device table 

chrtbl db 'CRT ' ; console VDT 

db mb$in$out+mb$serial+mb$soft$baud 
db baud$9600 

db 'LPT ' ; system serial printer 

db mb$output+mb$serial+mb$sof t$baud+mb$xon 
db baud$9600 

db 'TI810 ' ; alternate printer 

db mb$output+mb$ser ial+mb$sof t$baud 
db baud$9600 

db 'MODEM ' ; 300 baud modem port 

db mb$in$out+mb$serial+mb$soft$baud 
db baud$300 

db 'VAX ' ; interface to VAX 11/780 

db mb$in$out+mb$serial+mb$soft$baud 
db baud$9600 

db 'DIABLO* ; Diablo 630 daisy wheel printer 

db mb$output+mb$serial+mb$sof t$baud+mb$xon$xoff 
db baud$1200 

db 'CEN ' ; Centronics type parallel printer 

db mb$output 
db baud$none 

db ; table terminator 

Listing 3-2. Sample Character Device Table 



Listing 3-3 shows the equates for the fields contained in the 
sample character device table. Many systems do not support all of 
these baud rates. 



All Information Presented Here is Proprietary to Digital Research 

33 



CP/M 3 System Guide 



3.2 Character I/O Data Structures 



equates for mode byte fields 



mb$ input 
mb$output 
mb$in$out 
mb$sof t$baud 

mb$serial 
mb$xon$xoff 



equ 0000$0001b ; device may do input 
equ 0000$0010b ; device may do output 
equ mb$input+mb$output ; dev may do both 



equ 0000$0100b 

equ 0000$1000b 
equ 0001$0000b 



software selectable 

baud rates 

device may use protocol 

XON/XOFF protocol 

enabled 



equates for baud rate byte 



baud$none 

baud$50 

baud$75 

baud$110 

baud$134 

baud$150 

baud$300 

baud$600 

baud$1200 

baud$1800 

baud$2400 

baud$3600 

baud$4800 

baud$7200 

baud$9600 

baud$19200 



equ 

equ 1 
equ 2 
equ 3 
equ 4 
equ 5 
equ 6 
equ 7 
equ 8 
equ 9 
equ 10 
equ 11 
equ 12 
equ 13 
equ 14 
equ 15 



no baud rate 

associated with device 

50 baud 

75 baud 

110 baud 

134.5 baud 

150 baud 

300 baud 

600 baud 

1200 baud 

1800 baud 

2400 baud 

3600 baud 

4800 baud 

7200 baud 

9600 baud 

19.2k baud 



Listing 3-3. Equates for Node Byte Bit Fields 



3.3 BIOS Disk Data Structures 

The BIOS includes tables that describe the particular 
characteristics of the disk subsystem used with CP/M 3. This 
section describes the elements of these tables. 

In general, each disk drive has an associated Disk Parameter 
Header (DPH) that contains information about the disk drive and 
provides a scratchpad area for certain BDOS operations. One of the 
elements of this Disk Parameter Header is a pointer to the Disk 
Parameter Block (DPB) , which contains the actual disk description. 

In the banked system, only the Disk Parameter Block must reside 
in common memory. The DPHs, checksum vectors, allocation vectors, 
Buffer Control Blocks, and Directory Buffers can reside in common 
memory or Bank 0. The hash tables can reside in common memory or 
any bank except Bank 1. The data buffers can reside in banked 
memory if you implement the XMOVE function. 



All Information Presented Here is Proprietary to Digital Research 

34 



CP/M 3 System Guide 



3.3 BIOS Data Structures 



Figure 3-1 shows the relationships between the drive table, the 
Disk Parameter Header, and the Data and Directory Buffer Control 
Block fields and their respective data structures and buffers. 
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Figure 3-1. Disk Data Structures in a Banked System 
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3.3.1 The Drive Table 

The drive table consists of 16 words containing the addresses 
of the Disk Parameter Headers for each logical drive name, A through 
P, and takes the general form: 



drivetable dw dphO 
dw dphl 
dw dph2 



dw 



dphF 



If a logical drive does not exist in your system, the corresponding 
entry in the drive table must be zero. 

The GENCPM utility accesses the drive table to locate the 
various disk parameter data structures, so that it can determine 
which system configuration to use, and optionally allocate the 
various buffers itself. You must supply a drive table if you want 
GENCPM to do this allocation. If certain addresses in the Disk 
Parameter Headers referenced by this drive table are set to OFFFEH, 
GENCPM allocates the appropriate data structures and updates the 
DPH. You can supply the drive table even if you have performed your 
own memory allocation. See the BIOS DRVTBL function described in 
section 3.4.1. 



3.3.2 Disk Parameter Header 

In Figure 3-2, which shows the format of the Disk Parameter 
Header, b refers to bits. 



XLT 


-0- 


MF 


DPB 


CSV 


ALV 


DIRBCB 


DTABCB 


HASH 


HBANK 


16b 


72b 


8b 


16b 


16b 


16b 


16b 


16b 


16b 


8b 



Figure 3-2. Disk Parameter Header Format 



Table 3-2 describes the fields of the Disk Parameter Header. 
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Table 3-2. Disk Parameter Header Fields 



Field 



Comments 



XLT 



-0- 



MF 



DPB 



Set the XLT field to the address of the logical to 
physical sector translation table. If there is no 
sector translation and the physical and logical 
sector numbers are the same, set XLT to 0000H. Disk 
drives with identical sector skew factors can share 
the same translate table. 

XLT is the value passed to SECTRN in registers DE. 
Usually the translation table consists of one byte 
per physical sector. Generally, it is advisable to 
keep the number of physical sectors per logical 
track to a reasonable value to prevent the 
translation table from becoming too large. In the 
case of disks with multiple heads, you can compute 
the head number from the track address rather than 
the sector address. 



These 72 bits (9 bytes) of zeroes are the scratch 
area the BDOS uses to maintain various parameters 
associated with the drive. 



MF is the Media Flag. The BDOS resets MF to zero 
when the drive is logged in. The BIOS can set this 
flag and @MEDIA in the SCB to OFFH if it detects 
that a drive door has been opened. If the flag is 
set to OFFH, the BDOS checks for a media change 
prior to performing the next BDOS file operation on 
that drive. If the BDOS determines that the drive 
contains a new volume, the BDOS performs a login on 
that drive, and resets the MF flag to 00H. Note 
that the BDOS checks this flag only when a system 
call is made, and not during an operation. 
Usually, this flag is used only by systems that 
support door-open interrupts. 



Set the DPB field to the address of a Disk 
Parameter Block that describes the characteristics 
of the disk drive. Several Disk Parameter Headers 
can address the same Disk Parameter Block if their 
drive characteristics are identical. (The Disk 
Parameter Block is described in Section 3.3.3.) 
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Table 3-2. (continued) 



Field 



Comments 



CSV 



ALV 



CSV is the address of a scratchpad area used to 
detect changed disks. This address must be 
different for each removable media Disk Parameter 
Header. There must be one byte for every 4 
directory entries (or 128 bytes of directory) . In 
other words, length (CSV) = (DRM/4)+l. (See Table 
3-3 for an explanation of the DRM field.) If the 
drive is permanently mounted, set the CKS variable 
in the DPB to 8000H and set CSV to 0000H. This 
way, no storage is reserved for a checksum vector. 
The checksum vector may be located in common memory 
or in Bank 0. Set CSV to OFFFEH for GENCPM to set 
up the checksum vector. 



ALV is the address of the scratchpad area called 
the allocation vector, which the BDOS uses to keep 
disk storage allocation information. This area 
must be unique for each drive. 

The allocation vector usually requires 2 bits for 
each block on the drive. Thus, length (ALV) = 
(DSM/4) + 2. (See Table 3-3 for an explanation of 
the DSM field.) In the nonbanked version of CP/M 
3, you can optionally specify that GENCPM reserve 
only one bit in the allocation vector per block on 
the drive. In this case, length (ALV) = (DSM/8) + 
1. 

The GENCPM option to use single-bit allocation 
vectors is provided in the nonbanked version of 
CP/M 3 because additional memory is required by the 
double-bit allocation vector. This option applies 
to all drives on the system. 

With double-bit allocation vectors, CP/M 3 
automatically frees, at every system warm start, 
all file blocks that are not permanently recorded 
in the directory. Note that file space allocated 
to a file is not permanently recorded in a 
directory unless the file is closed. Therefore, 
the allocation vectors in memory can indicate that 
space is allocated although directory records 
indicate that space is free for allocation. With 
single-bit allocation vectors, CP/M 3 requires that 
a drive be reset before this space can be 
reclaimed. Because it increases performance, CP/M 
3 does not reset disks at system warm start. Thus, 
with single-bit allocation vectors, if you do not 
reset the disk system, DIR and SHOW can report an 
inaccurate amount of free space. With single-bit 
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Table 3-2. (continued) 



Field 



Comments 



ALV 
(continued) 



DIRBCB 



DTABCB 



HASH 



allocation vectors, the user must type a CTRL-C at 
the system prompt to reset the disk system to ensure 
accurate reporting of free space. Set ALV to 
OFFFEH for GENCPM to automatically assign space 
for the allocation vector, single- or double-bit, 
during system generation. In the nonbanked system, 
GENCPM prompts for the type of allocation vector. 
In the banked system, the allocation vector is 
always double-bit and can reside in common memory 
or Bank 0. When GENCPM automatically assigns space 
for the allocation vector (ALV = OFFFEH) , it places 
the allocation vector in Bank 0. 



Set DIRBCB to the address of a single directory 
Buffer Control Block (BCB) in an unbanked system. 
Set DIRBCB to the address of a BCB list head in a 
banked system. 

Set DIRBCB to OFFFEH for GENCPM to set up the 
DIRBCB field. The BDOS uses directory buffers for 
all accesses of the disk directory. Several DPHs 
can refer to the same directory BCB or BCB list 
head; or, each DPH can reference an independent BCB 
or BCB list head. Section 3.3.4 describes the 
format of the Buffer Control Block. 



Set DTABCB to the address of a single data BCB in 
an unbanked system. Set DTABCB to the address of a 
data BCB list head in a banked system. 

Set DTABCB to OFFFEH for GENCPM to set up the 
DTABCB field. The BDOS uses data buffers to hold 
physical sectors so that it can block and deblock 
logical 128-byte records. If the physical record 
size of the media associated with a DPH is 128 
bytes, you can set the DTABCB field of the DPH to 
OFFFFH, because in this case, the BDOS does not use 
a data buffer. 



HASH contains the address of the optional directory 
hashing table associated with a DPH. Set HASH to 
OFFFFH to disable directory hashing. 
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Table 3-2. (continued) 



Field 



Comments 



HASH 
(continued) 



HBANK 



Set HASH to OFFFEH to make directory hashing on the 
drive a GENCPM option. Each DPH using hashing must 
reference a unique hash table. If a hash table is 
supplied, it must be 4*(DRM+1) bytes long, where 
DRM is one less than the length of the directory. 
In other words, the hash table must contain four 
bytes for each directory entry of the disk. 



Set HBANK to the bank number of the hash table. 
HBANK is not used in unbanked systems and should be 
set to zero. The hash tables can be contained in 
the system bank, common memory, or any alternate 
bank except Bank 1, because hash tables cannot be 
located in the Transient Program Area. GENCPM 
automatically sets HBANK when HASH is set to 
OFFFEH. 



3.3.3 Disk Parameter Block 

Figure 3-3 shows the format of the Disk Parameter Block, where 
b refers to bits. 



SPT 


BSH 


BLM 


EXM 


DSM 


DRM 


ALO 


AL1 


CKS 


OFF 


PSH 


PHM 


16b 


8b 


8b 


8b 


16b 


16b 


8b 


8b 


16b 


16b 


8b 


8b 



Figure 3-3. Disk Parameter Block Format 



Table 3-3 describes the fields of the Disk Parameter Block. 



Table 3-3. Disk Parameter Block Fields 



Field 



Comments 



SPT Set SPT to the total number of 128-byte logical 
records per track. 

BSH Data allocation block shift factor. The value 
of BSH is determined by the data block 
allocation size. 

BLM Block mask. The value of BLM is determined by 
the data block allocation size. 
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Table 3-3. (continued) 



Field 



Comments 



EXM Extent mask determined by the data block 
allocation size and the number of disk blocks. 

DSM Determines the total storage capacity of the 
disk drive. DSM is one less than the total 
number of blocks on the drive. 

DRM Total number of directory entries minus one that 
can be stored on this drive. The directory 
requires 32 bytes per entry. 

ALO, ALl Determine reserved directory blocks. See Figure 
3-8 for more information. 

CKS The size of the directory check vector, 
(DRM/4)+l. Set bit 15 of CKS to 1 if the drive 
is permanently mounted. Set CKS to 8000H to 
indicate that the drive is permanently mounted 
and directory checksumming is not required. 

Note: full directory checksumming is required 
on removable media to support the automatic 
login feature of CP/M 3. 

OFF The number of reserved tracks at the beginning 
of the logical disk. OFF is the track on which 
the directory starts. 

PSH Specifies the physical record shift factor. 

PHM Specifies the physical record mask. 



CP/M allocates disk space in a unit called a block. Blocks are 
also called allocation units, or clusters. BLS is the number of 
bytes in a block. The block size can be 1024, 2048, 4096, 8192, or 
16384 (decimal) bytes. 

A large block size decreases the size of the allocation vectors 
but can result in wasted disk space. A smaller block size increases 
the size of the allocation vectors because there are more blocks on 
the same size disk. 

There is a restriction on the block size. If the block size is 
10 24, there cannot be more than 255 blocks present on a logical 
drive. In other words, if the disk is larger than 256K, it is 
necessary to use at least 2048 byte blocks. 

The value of BLS is not a field in the Disk Parameter Block; 
rather, it is derived from the values of BSH and BLM as given in 
Table 3-4. 
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Table 3-4. BSH and BLM Values 



BLS 


BSH 


BLM 


1,024 


3 


7 


2,048 


4 


15 


4,096 


5 


31 


8,192 


6 


63 


16,384 


7 


127 



The block mask, BLM, equals one less than the number of 128- 
byte records in an allocation unit, (BLS/128 - 1), or (2**BSH)-1. 

The value of the Block Shift Factor, BSH, is determined by the 
data block allocation size. The Block Shift Factor (BSH) equals the 
logarithm base two of the block size in 128-byte records, or 
LOG2 (BLS/128) , where LOG2 represents the binary logarithm function. 

The value of EXM depends upon both the BLS and whether the DSM 
value is less than 256 or greater than 255, as shown in Table 3-5. 



Table 


3- 


-5 


Maximum 


EXM Values 


BLS 






EXM 


values 








DSM<256 


DSM>255 


1,024 
2,048 
4,096 
8,192 
16,384 







1 
3 
7 
15 




N/A 

1 
3 
7 



The value of EXM is one less than the maximum number of 16K 
extents per FCB. 

Set EXM to zero if you want media compatibility with an 
extended CP/M 1.4 system. This only applies to double-density CP/M 
1.4 systems, with disk sizes greater than 256K bytes. It is 
preferable to copy double-density 1.4 disks to single-density, then 
reformat them and recreate them with the CP/M 3 system, because CP/M 
3 uses directory entries more effectively than CP/M 1.4. 

DSM is one less than the total number of blocks on the drive. 
DSM must be less than or equal to 7FFFH. If the disk uses 1024 byte 
blocks (BSH=3, BLM=7), DSM must be less than or equal to 00FFH. The 
product BLS*(DSM+1) is the total number of bytes the drive holds and 
must be within the capacity of the physical disk. It does not 
include the reserved operating system tracks. 
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The DRM entry is one less than the total number of 32-byte 
directory entries, and is a 16-bit value. DRM must be less than or 
equal to (BLS/32 * 16) - 1. DRM determines the values of ALO and 
ALL The two fields ALO and AL1 can together be considered a string 
of 16 bits, as shown in Figure 3-4. 



ALO 



AL1 



00 


01 


02 


03 


04 


05 


06 


07 


08 


09 


10 


11 


12 


13 


14 


15 



Figure 3-4. ALO and AL1 



Position 00 corresponds to the high-order bit of the byte 
labeled ALO, and position 15 corresponds to the low-order bit of the 
byte labeled ALL Each bit position reserves a data block for a 
number of directory entries, thus allowing a maximum of 16 data 
blocks to be assigned for directory entries. Bits are assigned 
starting at 00 and filled to the right until position 15. ALO and 
AL1 overlay the first two bytes of the allocation vector for the 
associated drive. Table 3-6 shows DRM maximums for the various 
block sizes. 



Table 3-6. BLS and Number of Directory Entries 



BLS 



Directory Entries 



Maximum DRM 



1,024 
2,048 
4,096 
8,192 
16,384 



32 * reserved blocks 

64 * reserved blocks 

128 * reserved blocks 

256 * reserved blocks 

512 * reserved blocks 



511 
1,023 
2,047 
4,095 
8,191 



If DRM = 127 (128 directory entries) , and BLS = 1024, there are 
32 directory entries per block, requiring 4 reserved blocks. In 
this case, the 4 high-order bits of ALO are set, resulting in the 
values ALO = 0F0H and AL1 = 00H. The maximum directory allocation 
is 16 blocks where the block size is determined by BSH and BLM. 

The OFF field determines the number of tracks that are skipped 
at the beginning of the physical disk. It can be used as a 
mechanism for skipping reserved operating system tracks, which on 
system disks contain the Cold Boot Loader, CPMLDR, and possibly the 
CCP. It is also used to partition a large disk into smaller 
segmented sections. 
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PSH and PHM determine the physical sector size of the disk. 
All disk I/O is in terms of the physical sector size. Set PSH and 
PSM to zero if the BIOS is blocking and deblocking instead of the 
BDOS. 

PSH specifies the physical record shift factor, ranging from 
to 5, corresponding to physical record sizes of 128, 256, 512, IK, 
2K, or 4K bytes. It is equal to the logarithm base two of the 
physical record size divided by 128, or L0G2 (sector_size/128) . See 
Table 3-7 for PSH values. 

PHM specifies the physical record mask, ranging from to 31, 
corresponding to physical record sizes of 128, 256, 512, IK, 2K, or 
4K bytes. It is equal to one less than the sector size divided by 
128, or, (sector size/128) -1. See Table 3-7 for PHM values. 



Table 3-7. 


PSH and PHM Values 


Sector 








size 




PSH 


PHM 


128 





256 


1 1 


512 


2 3 


1,024 


3 7 


2,048 


4 15 


4,096 


5 31 



3.3.4 Buffer Control Block 

A Buffer Control Block (BCB) locates physical record buffers 
for the BDOS. The BDOS uses the BCB to manage the physical record 
buffers during processing. More than one Disk Parameter Header can 
specify the same BCB. The GENCPM utility can create the Buffer 
Control Block. 

Note that the BANK and LINK fields of the Buffer Control Block 
are present only in the banked system. Therefore, the Buffer 
Control Block is twelve bytes long in the nonbanked system, and 
fifteen bytes long in the banked system. Note also that only the 
DRV, BUFFAD, BANK, and LINK fields need to contain initial values. 
In Figure 3-5, which shows the form of the Buffer Control Block, b 
refers to bits. 



DRV 


REC# 


WFLG 


00 


TRACK 


SECTOR 


BUFFAD 


BANK 


LINK 


8b 


24b 


8b 


8b 


16b 


16b 


16b 


8b 


16b 



Figure 3-5. Buffer Control Block Format 



All Information Presented Here is Proprietary to Digital Research 

44 



CP/M 3 System Guide 



3.3 BIOS Data Structures 



Table 3-8 describes the fields of each Buffer Control Block. 



Table 3-8. Buffer Control Block Fields 



Field 



Comment 



DRV Identifies the disk drive associated with the 
record contained in the buffer located at 
address BUFFAD. If you do not use GENCPM to 
allocate buffers, you must set the DRV field to 
OFFH. 

REC# Identifies the record position of the current 
contents of the buffer located at address 
BUFFAD. REC# consists of the absolute sector 
number of the record where the first record of 
the directory is zero. 

WFLG Set by the BDOS to OFFH to indicate that the 
buffer contains new data that has not yet been 
written to disk. When the data is written, the 
BDOS sets the WFLG to zero to indicate the 
buffer is no longer dirty. 

00 Scratch byte used by BDOS. 

TRACK Contains the physical track location of the 
contents of the buffer . 

SECTOR Contains the physical sector location of the 
contents of the buffer. 

BUFFAD Specifies the address of the buffer associated 
with this BCB. 

BANK Contains the bank number of the buffer 
associated with this BCB. This field is only 
present in banked systems. 

LINK Contains the address of the next BCB in a 
linked list, or zero if this is the last BCB in 
the linked list. The LINK field is present 
only in banked systems. 



The BDOS distinguishes between two kinds of buffers: data 
buffers referenced by DTABCB, and directory buffers referenced by 
DIRBCB. In a banked system, the DIRBCB and DTABCB fields of a Disk 
Parameter Header each contain the address of a BCB list head rather 
than the address of an actual BCB. A BCB list head is a word 
containing the address of the first BCB in a linked list. If 
several DPHs reference the same BCB list, they must reference the 
same BCB list head. Each BCB has a LINK field that contains the 
address of the next BCB in the list, or zero if it is the last BCB. 



All Information Presented Here is Proprietary to Digital Research 

45 



CP/M 3 System Guide 3.3 BIOS Data Structures 



In banked systems, the one-byte BANK field indicates the bank 
in which the data buffers are located. The BANK field of directory 
BCBs must be zero because directory buffers must be located in Bank 
0, usually below the banked BDOS module, or in common memory. The 
BANK field is for systems that support direct memory-to-memory 
transfers from one bank to another. (See the BIOS XMOVE entry point 
in Section 3.4.4.) 

The BCB data structures in a banked system must reside in Bank 
or in common memory. The buffers of data BCBs can be located in 
any bank except Bank 1 (the Transient Program Area) . 

For banked systems that do not support interbank block moves 
through XMOVE, the BANK field must be set to and the data buffers 
must reside in common memory. The directory buffers can be in Bank 
even if the system does not support bank-to-bank moves. 

In the nonbanked system, the DPH DIRBCB and DTABCB can point to 
the same BCB if the DPH defines a fixed media device. For devices 
with removable media, the DPH DIRBCB and the DPH DTABCB must 
reference different BCBs. In banked systems, the DPH DIRBCB and 
DTABCB must point to separate list heads. 

In general, you can enhance the performance of CP/M 3 by 
allocating more BCBs, but the enhancement reduces the amount of TPA 
memory in nonbanked systems. 

If you set the DPH DIRBCB or the DPH DTABCB fields to OFFFEH, 
the GENCPM utility creates BCBs, allocates physical record buffers, 
and sets these fields to the address of the BCBs. This allows you 
to write device drivers without regard to buffer requirements. 

3.3.5 Data Structure Macro Definitions 

Several macro definitions are supplied with CP/M 3 to simplify 
the creation of some of the data structures in the BIOS. These 
macros are defined in the library file CPM3.LIB on the distribution 
disk. 

To reference these macros in your BIOS, include the following 
statement: 

MACLIB CPM3 
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DTBL Macro 

Use the DTBL macro to generate the drive table, DRVTBL. It has 
one parameter, a list of the DPHs in your system. The list is 
enclosed in angle brackets. 

The form of the DTBL macro call is 

label: DTBL <DPHA,DPHB, . . . ,DPHP> 

where DPHA is the address of the DPH for drive A, DPHB is the 
address of the DPH for drive B, up to drive P. For example, 

DRVTBL: DTBL <ACSHD0 ,FDSD0 ,FDSD1> 

This example generates the drive table for a three-drive system. 
The DTBL macro always generates a sixteen-word table, even if you 
supply fewer DPH names. The unused entries are set to zero to 
indicate the corresponding drives do not exist. 

DPH Macro 

The DPH macro routine generates a Disk Parameter Header (DPH) . 
It requires two parameters: the address of the skew table for this 
drive, and the address of the Disk Parameter Block (DPB) . Two 
parameters are optional: the maximum size of the checksum vector, 
and the maximum size of the allocation vector. If you omit the 
maximum size of the checksum vector and the maximum size of the 
allocation vector from the DPH macro invocation, the corresponding 
fields of the Disk Parameter Header are set to OFFFEH so that GENCPM 
automatically allocates the vectors. 

The form of the DPH macro call is 

label: DPH ?trans,?dpb, [?csize] , [?asize] 

where: 

? trans is the address of the translation vector for this 

drive; 
?dpb is the address of the DPB for this drive; 
?csize is the maximum size in bytes of the checksum 

vector; 
?asize is the maximum size in bytes of the allocation 

vector. 

The following example, which includes all four parameters, 
shows a typical DPH macro invocation for a standard single-density 
disk drive: 

FDSDO: DPH SKEW6 ,DPB$SD,16 , 31 
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SKEW Macro 

The SKEW macro generates a skew table and requires the 
following parameters: the number of physical sectors per track, the 
skew factor, and the first sector number on each track (usually or 
1). 

The form of the SKEW macro call is 

label: SKEW ?secs,?skf ,?f sc 

where: 

?secs is the number of physical sectors per track; 

?skf is the sector skew factor; 

?fsc is the first sector number on each track. 



The following macro invocation generates the skew table for a 
standard single-density disk drive. 

SKEW6: SKEW 26,6,1 

DPB Macro 

The DPB macro generates a Disk Parameter Block specifying the 
characteristics of a drive type. It requires six parameters: the 
physical sector size in bytes, the number of physical sectors per 
track, the total number of tracks on the drive, the size of an 
allocation unit in bytes, the number of directory entries desired, 
and the number of system tracks to reserve at the beginning of the 
drive. There is an optional seventh parameter that defines the CKS 
field in the DPB. If this parameter is missing, CKS is calculated 
from the directory entries parameter. 

The form of the DPB macro call is 

label: DPB ?psize,?pspt ,?trks,?bls,?ndirs,?of f [ , ?ncks] 

where: 

?psize is the physical sector size in bytes; 

?pspt is the number of physical sectors per track; 

?trks is the number of tracks on the drive; 

?bls is the allocation unit size in bytes; 

?ndirs is the number of directory entries; 

?off is the number of tracks to reserve; 

?ncks is the number of checked directory entries. 

The following example shows the parameters for a standard 
single-density disk drive: 

DPB$SD: DPB 128,26,77,1024,64,2 
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The DPB macro can be used only when the disk drive is under 
eight megabytes. DPBs for larger disk drives must be constructed by 
hand. 



3.4 BIOS Subroutine Entry Points 

This section describes the entry parameters, returned values, 
and exact responsibilities of each BIOS entry point in the BIOS jump 
vector. The routines are arranged by function. Section 3.4.1 
describes system initialization. Section 3.4.2 presents the 
character I/O functions, followed by Section 3.4.3, discussing the 
disk I/O functions. Section 3.4.4 discusses the BIOS memory select 
and move functions. The last section, 3.4.5, discusses the BIOS 
clock support function. Table 3-9 shows the BIOS entry points the 
BDOS calls to perform each of the four categories of system 
functions. 



Table 3-9. Functional 


Organization of BIOS Entry Points 


Operation 


Function 


System Initializat 


Lon 


BOOT, WBOOT, DEVTBL, DEVINI, 
DRVTBL, 


Character I/O 




CONST, CONIN, CONOUT, LIST, 
AUXOUT, AUXIN, LISTST, CONOST, 
AUXIST, AUXOST 


Disk I/O 




HOME, SELDSK, SETTRK, SETSEC, 
SETDMA, READ, WRITE, SECTRN, 
MULTIO, FLUSH 


Memory Selects and 


Moves 






MOVE, XMOVE, SELMEM, SETBNK 


Clock Support 




TIME 



Table 3-10 is a summary showing the CP/M 3 BIOS function 
numbers, jump instruction names, and the entry and return parameters 
of each jump instruction in the table, arranged according to the 
BIOS function number. 
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Table 3-10. 


CP/M 3 BIOS Function Jump Table Summary 


NO. 


Function 


Input 


Output 





BOOT 


None 


None 


1 


WBOOT 


None 


None 


2 


CONST 


None 


A=0FFH if ready 
A=00H if not ready 


3 


CON IN 


None 


A=Con Char 


4 


CONOUT 


C=Con Char 


None 


5 


LIST 


C=Char 


None 


6 


AUXOUT 


C=Char 


None 


7 


AUXIN 


None 


A=Char 


8 


HOME 


None 


None 


9 


SELDSK 


C=Drive 0-15 


HL=DPH addr 






E=Init Sel Flag 


HL=000H if invalid dr. 


10 


SETTRK 


BC=Track No 


None 


11 


SETSEC 


BC=Sector No 


None 


12 


SETDMA 


BC=.DMA 


None 


13 


READ 


None 


A=00H if no Err 

A=01H if Non-recov Err 

A=0FFH if media changed 


14 


WRITE 


C=Deblk Code 


A=00H if no Err 
A=01H if Phys Err 
A=02H if Dsk is R/O 
A=0FFH if media changed 


15 


LISTST 


None 


A=00H if not ready 
A=0FFH if ready 


16 


SECTRN 


BC=Log Sect No 


HL=Phys Sect No 
DE=Trans Tbl Adr 


17 


CONOST 


None 


A=00H if not ready 
A=0FFH if ready 


18 


AUXIST 


None 


A=00H if not ready 
A=0FFH if ready 


19 


AUXOST 


None 


A=00H if not ready 
A=0FFH if ready 


20 


DEVTBL 


None 


HL=Chrtbl addr 


21 


DEVINI 


C=Dev No 0-15 


None 


22 


DRVTBL 


None 


HL=Drv Tbl addr 
HL=0FFFFH 
HL=0FFFEH 
HL=0FFFDH 


23 


MULT 10 


C=Mult Sec Cnt 


None 


24 


FLUSH 


None 


A=000H if no err 
A=001H if phys err 
A=002H if disk R/O 


25 


MOVE 


HL=Dest Adr 


HL & DE point to next 






DE=Source Adr 


bytes following MOVE 


26 


TIME 


C=Get/Set Flag 


None 


27 


SELMEM 


A=Mem Bank 


None 


28 


SETBNK 


A=Mem Bank 


None 


29 


XMOVE 


B=Dest Bank 
C=Source Bank 
BC=Count 


None 
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Table 3-10 


(continued) 


No. 


Function 


Input 


30 
31 
32 


USERF 

RESERVl 

RESERV2 


Reserved for 
Reserved for 
Reserved for 


System Implementor 
Future Use 
Future Use 



3.4.1 System Initialization Functions 

This section defines the BIOS system initialization routines 
BOOT, WBOOT, DEVTBL, DEVINI, and DRVTBL. 



BIOS Function 0: BOOT 



Get Control from Cold Start Loader 
and Initialize System 



Entry Parameters: None 
Returned Values: None 



The BOOT entry point gets control from the Cold Start Loader in 
Bank and is responsible for basic system initialization. Any 
remaining hardware initialization that is not done by the boot ROMs, 
the Cold Boot Loader, or the LDRBIOS should be performed by the BOOT 
routine. 

The BOOT routine must perform the system initialization 
outlined in Section 2.3, System Initialization. This includes 
initializing Page Zero jumps and loading the CCP. BOOT usually 
prints a sign-on message, but this can be omitted. Control is then 
transferred to the CCP in the TPA at 0100H. 

To initialize Page Zero, the BOOT routine must place a jump at 
location 0000H to BIOS_base + 3, the BIOS warm start entry point. 
The BOOT routine must also place a jump instruction at location 
0005H to the address contained in the System Control Block variable, 
@MXTPA. 

The BOOT routine must establish its own stack area if it calls 
any BDOS or BIOS routines. In a banked system, the stack is in Bank 
when the Cold BOOT routine is entered. The stack must be placed 
in common memory. 
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BIOS Function 1: WBOOT 



Get Control When a Warm Start Occurs 



Entry Parameters: None 
Returned Values: None 



The WBOOT entry point is entered when a warm start occurs. A 
warm start is performed whenever a user program branches to location 
0000H or attempts to return to the CCP. The WBOOT routine must 
perform the system initialization outlined in BIOS Function 0, 
including initializing Page Zero jumps and loading the CCP. 

When your WBOOT routine is complete, it must transfer control 
to the CCP at location 0100H in the TPA. 

Note that the CCP does not reset the disk system at warm start. 
The CCP resets the disk system when a CTRL-C is pressed following 
the system prompt. 

Note also that the BIOS stack must be in common memory to make 
BDOS function calls. Only the BOOT and WBOOT routines can perform 
BDOS function calls. 

If the WBOOT routine is reading the CCP from a file, it must 
set the multisector I/O count, @MLTIO in the System Control Block, 
to the number of 128-byte records to be read in one operation before 
readingCCP.COM. You can directly set @MLTI0 in the SCB, or you can 
call BDOS Function 44 to set the multisector count in the SCB. 

If blocking/ deblocking is done in the BIOS instead of in the 
BDOS, the WBOOT routine must discard all pending buffers. 



BIOS Function 20: DEVTBL 



Return Address of Character I/O Table 



Entry Parameters: None 

Returned Values: HL= address of Chrtbl 



The DEVTBL and DEV-INI entry points allow you to support device 
assignment with a flexible, yet completely optional system. It 
replaces the IOBYTE facility of CP/M 2.2. Note that the CHRTBL must 
be in common in banked systems. 
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BIOS Function 21: DEVINI 



Initialize Character I/O Device 



Entry Parameters: C=device number, 0-15 
Returned Values: None 



The DEVINI routine initializes the physical character device 
specified in register C to the baud rate contained in the 
appropriate entry of the CHRTBL. It need only be supplied if I/O 
redirection has been implemented and is referenced only by the 
DEVICE utility supplied with CP/M 3. 



BIOS Function 22: DRVTBL 



Return Address of Disk Drive Table 



Entry Parameters: None 



Returned Values: 



HL=Address of Drive Table of Disk 
Parameter Headers (DPH); Hashing 
can be utilized if specified by 
the DPHs referenced by this DRVTBL. 

HL=0FFFFH if no Drive Table; the BDOS is 
responsible for blocking/ deblocking; 
Hashing is supported. 

HL=0FFFEH if no Drive Table; the BDOS is 
responsible for blocking/deblocking; 
Hashing is not supported. 



The first instruction of this subroutine must be an LXI 
H,<address> where <address> is one of the above returned values. 
The GENCPM utility accesses the address in this instruction to 
locate the drive table and the disk parameter data structures to 
determine which system configuration to use. 

If you plan to do your own blocking/ deblocking, the first 
instruction of the DRVTBL routine must be the following: 



lxi 



h,0FFFEh 



You must also set the PSH and PSM fields of the associated Disk 
Parameter Block to zero. 
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3.4.2 Character I/O Functions 

This section defines the CP/M 3 character I/O routines CONST, 
CONIN, CONOUT, LIST, AUXOUT , AUXIN, LISTST, CONOST, AUXIST, and 
AUXOST. 

CP/M 3 assumes all simple character I/O operations are 
performed in eight-bit ASCII, upper- and lower-case, with no parity. 
An ASCII CTRL-Z (1AH) denotes an end-of-file condition for an input 
device. 

In CP/M 3, you can direct each of the five logical character 
devices to any combination of up to twelve physical devices. Each 
of the five logical devices has a 16-bit vector in the System 
Control Block (SCB) . Each bit of the vector represents a physical 
device where bit 15 corresponds to device zero, and bit 4 is device 
eleven. Bits through 3 are reserved for future system use. 

You can use the public names defined in the supplied SCB. ASM 
file to reference the I/O redirection bit vectors. The names are 
shown in Table 3-11. 



Table 3-11. I/O Redirection Bit Vectors in SCB 



Name 



Logical Device 



@CIVEC 
@COVEC 
@AIVEC 
@AOVEC 
@LOVEC 



Console Input 
Console Output 
Auxiliary Input 
Auxiliary Output 
List Output 



You should send an output character to all of the devices whose 
corresponding bit is set. An input character should be read from 
the first ready device whose corresponding bit is set. 

An input status routine should return true if any selected 
device is ready. An output status routine should return true only 
if all selected devices are ready. 
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BIOS Function 2: CONST 



Sample the Status of the Console Input Device 



Entry Parameters: none 



Returned value: 



A= OFFH if a console character 

is ready to read 
A= 00H if no console character 

is ready to read 



Read the status of the currently assigned console device and 
return OFFH in register A if a character is ready to read, and 00H 
in register A if no console characters are ready. 



BIOS Function 3: CONIN 



Read a Character from the Console 



Entry Parameters: None 

Returned Values: A=Console Character 



Read the next console character into register A with no parity. 
If no console character is ready, wait until a character is 
available before returning. 



BIOS Function 4: CONOUT 



Output Character to Console 



Entry Parameters: C=Console Character 
Returned Values: None 



Send the character in register C to the console output device, 
The character is in ASCII with no parity. 
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BIOS Function 5: LIST 



Output Character to List Device 



Entry Parameters: C=Character 
Returned Values: None 



Send the character from register C to the listing device. The 
character is in ASCII with no parity. 



BIOS Function 6: AUXOUT 



Output a Character to the 
Auxiliary Output Device 



Entry Parameters: C=Character 
Returned Values: None 



Send the character from register C to the currently assigned 
AUXOUT device. The character is in ASCII with no parity. 



BIOS Function 7: AUXIN 



Read a Character from the 
Auxiliary Input Device 



Entry Parameters: None 
Returned Values: A=Character 



Read the next character from the currently assigned AUXIN 
device into register A with no parity. A returned ASCII CTRL-Z 
(1AH) reports an end-of-file. 
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BIOS Function 15: LISTST 


Return 


the Ready Status of the 
List Device 


Entry Parameters 
Returned Values: 


None 

A=000H if list device is not 
ready to accept a character 

A=0FFH if list device is 

ready to accept a character 



The BIOS LISTST function returns the ready status of the list 
device . 



BIOS Function 17: CONOST 



Return Output Status of Console 



Entry Parameters: None 

Returned Values: A=0FFH if ready 

A=0OH if not ready 



The CONOST routine checks the status of the console. CONOST 
returns an OFFH if the console is ready to display another 
character. This entry point allows for full polled handshaking 
communications support. 



BIOS Function 1.8: AUXIST 



Return Input Status of Auxiliary Port 



Entry Parameters: None 

Returned Values: A=0FFH if ready 

A=000H if not ready 



The AUXIST routine checks the input status of the auxiliary port. 
This entry point allows full polled handshaking for communications 
support using an auxiliary port. 
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BIOS Function 19: 



AUXOST 



Return Output Status of Auxiliary Port 



Entry Parameters: None 

Returned Values: A=0FFH if ready 

A=000H if not ready 



The AUXOST routine checks the output status of the auxiliary 
port. This routine allows full polled handshaking for 
communications support using an auxiliary port. 

3.4.3 Disk I/O Functions 

This section defines the CP/M 3 BIOS disk I/O routines HOME r 
SELDSK, SETTRK, SETSEC, SETDMA, READ, WRITE, SECTRN, MULTIO, and 
FLUSH. 



BIOS Function 8: 



HOME 



Select Track 00 of the Specified Drive 



Entry Parameters: None 
Returned Values: None 



Return the disk head of the currently selected disk to the 
track 00 position. Usually, you can translate the HOME call into a 
call on SETTRK with a parameter of 0. 



All Information Presented Here is Proprietary to Digital Research 

58 



CP/M 3 System Guide 



3.4 BIOS Subroutine Entry Points 



BIOS 


Function 9: SELDSK 


Select 


the Specified Disk Drive 


Entry Parameters: 
Returned Values: 


C=Disk Drive (0-15) 
E=Initial Select Flag 

HL=Address of Disk Parameter 

Header (DPH) if drive exists 
HL=000H if drive does not exist 



Select the disk drive specified in register C for further 
operations, where register C contains for drive A, 1 for drive B, 
and so on to 15 for drive P. On each disk select, SELDSK must 
return in HL the base address of a 25-byte area called the Disk 
Parameter Header. If there is an attempt to select a nonexistent 
drive, SELDSK returns HL=0000H as an error indicator. 

On entry to SELDSK, you can determine if it is the first time 
the specified disk is selected. Bit 0, the least significant bit in 
Register E, is set to if the drive has not been previously 
selected. This information is of interest in systems that read 
configuration information from the disk to set up a dynamic disk 
definition table. 

When the BDOS calls SELDSK with bit in Register E set to 1, 
SELDSK must return the same Disk Parameter Header address as it 
returned on the initial call to the drive. SELDSK can only return a 
0OOH indicating an unsuccessful select on the initial select call. 

SELDSK must return the address of the Disk Parameter Header on 
each call. Postpone the actual physical disk select operation until 
a READ or WRITE is performed. 



BIOS Function 10 : SETTRK 



Set Specified Track Number 



Entry Parameters: BC=Track Number 
Returned Values: None 



Register BC contains the track number for a subsequent disk 
access on the currently selected drive. Normally, the track number 
is saved until the next READ or WRITE occurs. 
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BIOS Function 11: 



SETSEC 



Set Specified Sector Number 



Entry Parameters: BC=Sector Number 
Returned Values: None 



Register BC contains the sector number for the subsequent disk 
access on the currently selected drive. This number is the value 
returned by SECTRN. Usually, you delay actual sector selection 
until a READ or WRITE operation occurs. 



BIOS Function 12: SETDMA 



Set Address for Subsequent Disk I/O 



Entry Parameters: BC=Direct Memory 

Access Address 

Returned Values: None 



Register BC contains the DMA (Direct Memory Access) address for 
the subsequent READ or WRITE operation. For example, if B = 00H and 
C = 80H when the BDOS calls SETDMA, then the subsequent read 
operation reads its data starting at 80H, or the subsequent write 
operation gets its data from 80H, until the next call to SETDMA 
occurs. 
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BIOS F 


unction 13: READ 


Read a Sector from the Specified Drive 


Entry Parameters: 
Returned Values: 


None 

A=000H if no errors occurred 
A=001H if nonrecoverable error 

condition occurred 
A=0FFH if media has changed 



Assume the BDOS has selected the drive, set the track, set the 
sector, and specified the DMA address. The READ subroutine attempts 
to read one sector based upon these parameters, then returns one of 
the error codes in register A as described above. 

If the value in register A is 0, then CP/M 3 assumes that the 
disk operation completed properly. If an error occurs, the BIOS 
should attempt several retries to see if the error is recoverable 
before returning the error code. 

If an error occurs in a system that supports automatic density 
selection, the system should verify the density of the drive. If 
the density has changed, return a OFFH in the accumulator. This 
causes the BDOS to terminate the current operation and relog in the 
disk. 



BIOS Function 14: WRITE 



Write a Sector to the Specified Disk 



Entry Parameters: 
Returned Values: 



C=Deblocking Codes 

A=000H if no error occurred 

A=001H if physical error occurred 

A=002H if disk is Read-Only 

A=0FFH if media has changed 



Write the data from the currently selected DMA address to the 
currently selected drive, track, and sector. Upon each call to 
WRITE, the BDOS provides the following information in register C: 

= deferred write 

1 = nondeferred write 

2 = deferred write to the first sector of a new data block 
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This information is provided for those BIOS implementations that do 
blocking/deblocking in the BIOS instead of the BDOS. 

As in READ, the BIOS should attempt several retries before 
reporting an error. 

If an error occurs in a system that supports automatic density 
selection, the system should verify the density of the drive. If 
the density has changed, return a OFFH in the accumulator. This 
causes the BDOS to terminate the current operation and relog in the 
disk. 



BIOS Function 16: SECTRN 



Translate Sector Number Given Translate Table 



Entry Parameters: BC=Logical Sector Number 

DE=Translate Table Address 



Returned Values: 



HL=Physical Sector Number 



SECTRN performs logical sequential sector address to physical 
sector translation to improve the overall response of CP/M 3. 
Digital Research ships standard CP/M disk with a skew factor of 6, 
where six physical sectors are skipped between each logical read 
operation. This skew factor allows enough time between sectors for 
most programs on a slow system to process their buffers without 
missing the next sector. In computer systems that use fast 
processors, memory, and disk subsystems, you can change the skew 
factor to improve overall response. Typically, most disk systems 
perform well with a skew of every other physical sector. You should 
maintain support of single-density, IBM 3740 compatible disks using 
a skew factor of 6 in your CP/M 3 system to allow information 
transfer to and from other CP/M users. 

SECTRN receives a logical sector number in BC, and a translate 
table address in DE. The logical sector number is relative to zero. 
The translate table address is obtained from the Disk Parameter 
Block for the currently selected disk. The sector number is used as 
an index into the translate table, with the resulting physical 
sector number returned in HL. For standard, single-density, eight- 
inch disk systems, the tables and indexing code are provided in the 
sample BIOS and need not be changed. 

Certain drive types either do not need skewing or perform the 
skewing externally from the system software. In this case, the skew 
table address in the DPH can be set to zero, and the SECTRN routine 
can check for the zero in DE and return with the physical sector set 
to the logical sector. 
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BIOS Function 23: MULTIO 



Set Count of Consecutive Sectors 
for READ or WRITE 



Entry Parameters: C = Multisector Count 
Returned Values: None 



To transfer logically consecutive disk sectors to or from 
contiguous memory locations, the BDOS issues a MULTIO call, followed 
by a series of READ or WRITE calls. This allows the BIOS to 
transfer multiple sectors in a single disk operation. The maximum 
value of the sector count is dependent on the physical sector size, 
ranging from 128 with 128-byte sectors, to 4 with 4096-byte sectors. 
Thus, the BIOS can transfer up to 16K directly to or from the TPA 
with a single operation. 

The BIOS can directly transfer all of the specified sectors to 
or from the DMA buffer in one operation and then count down the 
remaining calls to READ or WRITE. 

If the disk format uses a skew table to minimize rotational 
latency when single records are transferred, it is more difficult to 
optimize transfer time for multisector transfers. One way of 
utilizing the multisector count with a skewed disk format is to 
place the sector numbers and associated DMA addresses into a table 
until either the residual multisector count reaches zero, or the 
track number changes. Then you can sort the saved requests by 
physical sector to allow all of the required sectors on the track to 
be read in one rotation. Each sector must be transferred to or from 
its proper DMA address. 

When an error occurs during a multisector transfer, you can 
either reset the multiple sector counters in the BIOS and return the 
error immediately, or you can save the error status and return it to 
the BDOS on the last READ or WRITE call of the MULTIO operation. 
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BIOS Function 24: FLUSH 



Force Physical Buffer Flushing 
for User-supported Deblocking 



Entry Parameters: 
Returned Values: 



None 

A=000H if no error occurred 
A=001H if physical error occurred 
A=002H if disk is Read-Only 



The flush buffers entry point allows the system to force 
physical sector buffer flushing when your BIOS is performing its own 
record blocking and deblocking. 

The BDOS calls the FLUSH routine to ensure that no dirty 
buffers remain in memory. The BIOS should immediately write any 
buffers that contain unwritten data. 

Normally, the FLUSH function is superfluous, because the BDOS 
supports blocking/deblocking internally. It is required, however, 
for those systems that support blocking/deblocking in the BIOS, as 
many CP/M 2.2 systems do. 

Note: if you do not implement FLUSH, the routine must return a zero 
in Register 1A. You can accomplish this with the following 
instructions: 

xra a 

ret 



3.4.4 Memory Select and Move Functions 

This section defines the memory management functions MOVE, 
XMOVE, SELMEM, and SETBNK. 
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BIOS Function 25: 



MOVE 



Memory- to-Memory Block Move 



Entry Parameters: 



Returned Values: 



HL = Destination address 
DE = Source address 
BC = Count 

HL and DE must point to 
next bytes following move 
operation 



The BDOS calls the MOVE routine to perform memory to memory 
block moves to allow use of the Z80 LDIR instruction or special DMA 
hardware, if available. Note that the arguments in HL and DE.are 
reversed from the Z80 machine instruction, necessitating the use of 
XCHG instructions on either side of the LDIR. The BDOS uses this 
routine for all large memory copy operations. On return, the HL and 
DE registers are expected to point to the next bytes following the 
move. 

Usually, the BDOS expects MOVE to transfer data within the 
currently selected bank or common memory. However, if the BDOS 
calls the XMOVE entry point before calling MOVE, the MOVE routine 
must perform an interbank transfer. 
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BIOS Function 27: SELMEM 



Select Memory Bank 



Entry Parameters: A = Memory Bank 
Returned Values: None 



The SELMEM entry point is only present in banked systems. The 
banked version of the CP/M 3 BDOS calls SELMEM to select the current 
memory bank for further instruction execution or buffer references. 
You must preserve or restore all registers other than the 
accumulator, A, upon exit. 



BIOS Function 28: 



SETBNK 



Specify Bank for DMA Operation 



Entry Parameters: A = Memory Bank 
Returned Values: None 



SETBNK only occurs in the banked version of CP/M 3. SETBNK 
specifies the bank that the subsequent disk READ or WRITE routine 
must use for memory transfers. The BDOS always makes a call to 
SETBNK to identify the DMA bank before performing a READ or WRITE 
call. Note that the BDOS does not reference banks other than or 1 
unless another bank is specified by the BANK field of a Data Buffer 
Control Block (BCB) . 



BIOS Function 29: XMOVE 



Set Banks for Following MOVE 



Entry Parameters: B=destination bank 
C= source bank 

Returned Values: None 



XMOVE is provided for banked systems that support memory-to- 
memory DMA transfers over the entire extended address range. 
Systems with this feature can have their data buffers located in an 
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alternate bank instead of in common memory, as is usually required. 
An XMOVE call affects only the following MOVE call. All subsequent 
MOVE calls apply to the memory selected by the latest call to 
SELMEM. After a call to the XMOVE function, the following call to 
the MOVE function is not more than 128 bytes of data. If you do not 
implement XMOVE, the first instruction must be a RET instruction. 



3.4.5 Clock Support Function 

This section defines the clock support function TIME. 



BIOS Function 26: TIME 



Get and Set Time 



Entry Parameters: C = Time Get/Set Flag 
Returned values: None 



The BDOS calls the TIME function to indicate to the BIOS 
whether it has just set the Time and Date fields in the SCB, or 
whether the BDOS is about to get the Time and Date from the SCB. On 
entry to the TIME function, a zero in register C indicates that the 
BIOS should update the Time and Date fields in the SCB. A OFFH in 
register C indicates that the BDOS has just set the Time and Date in 
the SCB and the BIOS should update its clock. Upon exit, you must 
restore register pairs HL and DE to their entry values. 

This entry point is for systems that must interrogate the clock 
to determine the time. Systems in which the clock is capable of 
generating an interrupt should use an interrupt service routine to 
set the Time and Date fields on a regular basis. 

3.5 Banking Considerations 

This section discusses considerations for separating your BIOS 
into resident and banked modules. You can place part of your 
customized BIOS in common memory, and part of it in Bank 0. 
However, the following data structures and routines must remain in 
common memory: 

o the BIOS stack 

• the BIOS jump vector 

• Disk Parameter Blocks 

• memory management routines 

• the CHRTBL data structure 
o all character I/O routines 

• portions of the disk I/O routines 
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You can place portions of the disk I/O routines in the system 
bank, Bank 0. In a banked environment, if the disk I/O hardware 
supports DMA transfers to and from banks other than the currently 
selected bank, the disk I/O drivers can reside in Bank 0. If the 
system has a DMA controller that supports block moves from memory to 
memory between banks, CP/M 3 also allows you to place the blocking 
and deblocking buffers in any bank other than Bank 1, instead of 
common memory. 

If your disk controller supports data transfers only into the 
currently selected bank, then the code that initiates and performs a 
data transfer must reside in common memory. In this case, the disk 
I/O transfer routines must select the DMA bank, perform the 
transfer, then reselect Bank 0. The routine in common memory 
performs the following procedure: 

1) Selects the DMA bank that SETBNK saved. 

2) Performs physical I/O. 

3) Reselects Bank 0. 

4) Returns to the calling READ or WRITE routine in Bank 0. 

Note that Bank is in context (selected) when the BDOS calls 
the system initialization functions BOOT and DRVTBL; the disk I/O 
routines HOME, SELDSK, SETTRK, SETSEC, SETDMA, READ, WRITE, SECTRN, 
MULTIO, and FLUSH; and the memory management routines XMOVE and 
SETBNK. 

Bank or Bank 1 is in context when the BDOS calls the system 
initialization routines WBOOT, DEVTBL, andDEVINI; the character I/O 
routines CONST, CONIN, CONOUT, LIST, AUXOUT, AUXIN, LISTST, CONOST, 
AUXIST, and AUXOST, the memory select and move routines MOVE and 
SELMEM, and the clock support routine TIME. 

You can place a portion of the character I/O routines in Bank 
if you place the following procedure in common memory. 

1) Swap stacks to a local stack in common. 

2) Save the current bank. 

3) Select Bank 0. 

4) Call the appropriate character I/O routine. 

5) Reselect the saved bank. 

6) Restore the stack. 
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3.6 Assembling and Linking Your BIOS 

This section assumes you have developed a BI0S3.ASM or 
BNKBI0S3.ASM file appropriate to your specific hardware environment. 
Use the Digital Research Relocatable Macro Assembler RMAC™ to 
assemble the BIOS. Use the Digital Research Linker LINK-80™ to 
create the BI0S3.SPR and BNKBI0S3.SPR files. The SPR files are part 
of the input to the GENCPM program. 

In a banked environment, your CP/M 3 BIOS can consist of two 
segments: a banked segment and a common segment. This allows you 
to minimize common memory usage to maximize the size of the TPA. To 
prepare a banked BIOS, place code and data that must reside in 
common in the CSEG segment, and code and data that can reside in the 
system bank in the DSEG segment. When you link the BIOS, LINK-80 
creates the BNKBI0S3.SPR file with all the CSEG code and data first, 
and then the DSEG code and data. 

After assembling the BIOS with RMAC, link your BNKBIOS using 
LINK-80 with the [B] option. The [B] option aligns the DSEG on a 
page boundary, and places the length of the CSEG into the 
BNKBI0S3.SPR header page. 

Use the following procedure to prepare a BI0S3.SPR or 
BNKBIOS3.SPR file from your customized BIOS. 

1) Assemble your BI0S3.ASM or BNKBI0S3.ASM file with the 
relocatable assembler RMAC.COM to produce a relocatable 
file of type REL. Assemble SCB.ASM to produce the 
relocatable file SCB.REL. 

Assembling the Nonbanked BIOS: 

A>RMAC BIOS 3 

Assembling the Banked BIOS: 

A>RMAC BNKBIOS3 



2) Link the BI0S3.REL or BNKBI0S3.REL file and the SCB.REL file 
with LINK-80 to produce the BI0S3.SPR or BNKBI0S3.SPR file. 
The [OS] option with LINK causes the output of a System 
Page Relocatable (SPR) file. 

Linking the Nonbanked BIOS: 

A>LINK BIOS3[OS]=BIOS3,SCB 

Linking the Banked BIOS: 

A>LINK BNKBIOS3[B]=BNKBIOS3 f SCB 
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The preceding examples show command lines for linking a banked 
and nonbanked BIOS. In these examples, the BI0S3.REL and 
BNKBI0S3.REL are the files of your assembled BIOS. SCB.REL contains 
the definitions of the System Control Block variables. The [B] 
option implies the [OS] option. 

End of Section 3 
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This section discusses the modular organization of the example 
CP/M 3 BIOS on your distribution disk. For previous CP/M operating 
systems, it was necessary to generate all input/output drivers from 
a single assembler source file. Such a file is difficult to 
maintain when the BIOS supports several peripherals. As a result, 
Digital Research is distributing the BIOS for CP/M 3 in several 
small modules. 

The organization of the BIOS into separate modules allows you 
to write or modify any I/O driver independently of the other 
modules. For example, you can easily add another disk I/O driver 
for a new controller with minimum impact on the other parts of the 
BIOS. 



4.1 Functional Summary of BIOS Modules 

The modules of the BIOS are BIOSKRNL.ASM, SCB.ASM, BOOT. ASM, 
MOVE. ASM, CHARIO.ASM, DRVTBL.ASM, and a disk I/O module for each 
supported disk controller in the configuration. 

BIOSKRNL.ASM is the kernel, root, or supervisor module of the 
BIOS. The SCB.ASM module contains references to locations in the 
System Control Block. You can customize the other modules to 
support any hardware configuration. To customize your system, add 
or modify external modules other than the kernel and the SCB.ASM 
module. 

Digital Research supplies the BIOSKRNL.ASM module. This module 
is the fixed, invariant portion of the BIOS, and the interface from 
the BDOS to all BIOS- functions. It is supplied in source form for 
reference only, and you should not modify it except for the equate 
statement described in the following paragraph. 

You must be sure the equate statement (banked equ true) at the 
start of the BIOSKRNL.ASM source file is correct for your system 
configuration. Digital Research distributes the BIOSKRNL.ASM file 
for a banked system. If you are creating a BIOS for a nonbanked 
system, change the equate statement to the following: 

banked equ false 

and reassemble with RMAC. This is the only change you should make 
to the BIOSKRNL.ASM file. 

Table 4-1 summarizes the modules in the CP/M 3 BIOS. 
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Table 4-1. CP/M 3 BIOS Module Function Summary 



Module Function 



BIOSKRNL.ASM 



Performs basic system initialization, and 
dispatches character and disk I/O. 



SCB.ASM module 



Contains the public definitions of the 
various fields in the System Control Block. 
The BIOS can reference the public variables. 



BOOT. ASM module 



Performs system initialization other than 
character and disk I/O. BOOT loads the CCP 
for cold starts and reloads it for warm 
starts. 



CHARIO.ASM module 



Performs all character device initialization, 
input, output, and status polling. CHARIO 
contains the character device characteristics 
table. 



DRVTBL.ASM module 



points to the data structures for each 
configured disk drive. The drive table 
determines which physical disk unit is 
associated with which logical drive. The 
data structure for each disk drive is called 
an Extended Disk Parameter Header (XDPH) . 



Disk I/O modules 



Initialize disk controllers and execute READ 
and WRITE code for disk controllers. You 
must provide an XDPH for each supported unit, 
and a separate disk I/O module for each 
controller in the system. To add another 
disk controller for which a prewritten module 
exists, add its XDPH names to the DRVTBL and 
link in the new module. 
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Table 4-1. (continued) 



Module Function 



MOVE. ASM module 



Performs memory-to-memory moves and bank 
selects. 



4.2 Conventions Used in BIOS Modules 

The Digital Research RMAC relocating assembler and LINK-80 
linkage editor allow a module to reference a symbol contained in 
another module by name. This is called an external reference. The 
Microsoft® relocatable object module format that RMAC and LINK use 
allows six-character names for externally defined symbols. External 
names must be declared PUBLIC in the module in which they are 
defined. The external names must be declared EXTRN in any modules 
that reference them. 

The modular BIOS defines a number of external names for 
specific purposes. Some of these are defined as public in the root 
module, BIOSKRNL.ASM. Others are declared external in the root and 
must be defined by the system implementor. Section 4.4 contains a 
table summarizing all predefined external symbols used by the 
modular BIOS. 

External names can refer to either code or data. All 
predefined external names in the modular BIOS prefixed with a @ 
character refer to data items. All external names prefixed with a ? 
character refer to a code label. To prevent conflicts with future 
extensions, user-defined external names should not contain these 
characters. 



4.3 Interactions of Modules 

The root module of the BIOS, BIOSKRNL.ASM, handles all BDOS 
calls, performs interfacing functions, and simplifies the individual 
modules you need to create. 

4.3.1 Initial Boot 

BIOSKRNL.ASM initializes all configured devices in the 
following order: 

1) BIOSKRNL calls ?CINIT in the CHARIO module for each of the 
16 character devices and initializes the devices. 

2) BIOSKRNL invokes the INIT entry point of each XDPH in the 
FD1797SD module. 
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3) BIOSKRNL calls the ?INIT entry of the BOOT module to 
initialize other system hardware, such as memory 
controllers, interrupts, and clocks. It prints a sign-on 
message specific to the system, if desired. 

4) BIOSKRNL calls 7LDCCP in the BOOT module to load the CCP 
into the TPA. 

5) The BIOSKRNL module sets up Page Zero of the TPA with the 
appropriate jump vectors, and passes control to the CCP. 

4.3.2 Character I/O Operation 

The CHARIO module performs all physical character I/O. This 
module contains both the character device table (@CTBL) and the 
routines for character input, output, initialization, and status 
polling. The character device table, @CTBL, contains the ASCII name 
of each device, mode information, and the current baud rate of 
serial devices. 

To support logical to physical redirection of character 
devices, CP/M 3 supplies a 16-bit assignment vector for each logical 
device. The bits in these vectors correspond to the physical 
devices. The character I/O interface routines in BIOSKRNL handle 
all device assignment, calling the appropriate character I/O 
routines with the correct device number. The BIOSKRNL module also 
handles XON/XOFF processing on output devices where it is enabled. 

You can use the DEVICE utility to assign several physical 
devices to a logical device. The BIOSKRNL root module polls the 
assigned physical devices, and either reads a character from the 
first ready input device that is selected, or sends the character to 
all of the selected output devices as they become ready. 

4.3.3 Disk I/O Operation 

The BIOSKRNL module handles all BIOS calls associated with disk 
I/O. It initializes global variables with the parameters for each 
operation, and then invokes the READ or WRITE routine for a 
particular controller. The SELDSK routine in the BIOSKRNL calls the 
LOGIN routine for a controller when the BDOS initiates a drive 
login. This allows disk density or media type to be automatically 
determined. 

The DRVTBL module contains the sixteen-word drive table, @DTBL. 
The order of the entries in @DTBL determines the logical to physical 
drive assignment. Each word in @DTBL contains the address of a DPH, 
which is part of an XDPH, as shown in Table 4-10. The word contains 
a zero if the drive does not exist. The XDPH contains the addresses 
of the INIT, LOGIN, READ, and WRITE entry points of the I/O driver 
for a particular controller. When the actual drivers are called, 
globally accessible variables contain the various parameters of the 
operation, such as the track and sector. 
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4.4 Predefined Variables and Subroutines 

The modules of the BIOS define public variables which other 
modules can reference. Table 4-2 contains a summary of each public 
symbol and the module that defines it. 



Table 4-2. Public Symbols in CP/M 3 


BIOS 


Symbol 


Function and Use Def 


"ined in Module 


@ADRV 


Byte, Absolute drive code 


BIOSKRNL 


@CBNK 


Byte, Current CPU bank 


BIOSKRNL 


@CNT 


Byte, Multisector count 


BIOSKRNL 


@CTBL 


Table, Character device table 


CHARIO 


@DBNK 


Byte, Bank for disk I/O 


BIOSKRNL 


@DMA 


Word, DMA address 


BIOSKRNL 


@DTBL 


Table, Drive table 


DRVTBL 


@RDRV 


Byte, Relative drive code (UNIT) 


BIOSKRNL 


@SECT 


Word, Sector address 


BIOSKRNL 


@TRK 


Word, Track number 


BIOSKRNL 


?BANK 


Bank select 


MOVE 


?CI 


Character device input 


CHARIO 


?CINIT 


Character device initialization 


CHARIO 


?CIST 


Character device input status 


CHARIO 


7C0 


Character device output 


CHARIO 


?COST 


Character device output status 


CHARIO 


?INIT 


General initialization 


BOOT 


7LDCCP 


Load CCP for cold start 


BOOT 


7 MOVE 


Move memory to memory 


MOVE 


7PDEC 


Print decimal number 


BIOSKRNL 


7PDERR 


Print BIOS disk error header 


BIOSKRNL 


7PMSG 


Print message 


BIOSKRNL 


7RLCCP 


Reload CCP for warm start 


BOOT 


7XM0VE 


Set banks for extended move 


MOVE 


7TIME 


Set or Get time 


BOOT 



The System Control Block defines public variables that other 
modules can reference. The System Control Block variables @CiyEC, 
OCOVEC, @AIVEC, @AOVEC, and @LOVEC are referenced by BIOSKRNL. ASM. 
The variable @BNKBF can be used by 7LDCCP and 7RLCCP to implement 
interbank block moves. The public variable names @ERMDE, @FX, 
@RESEL, @VINFO, @CRDSK, @USRCD, and @CRDMA are used for error 
routines which intercept BDOS errors. The publics @DATE, @HOUR, 
@MIN, and @SEC can be updated by an inter rupt-driven real-time 
clock. @MXTPA contains the current BDOS entry point. 

Disk I/O operation parameters are passed in the following 
global variables, as shown in Table 4-3. 
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4.4 Predefined Variables and Subroutines 



Table 4-3. Global Variables in BIOSKRNL.ASM 



Variable 



Meaning 



@ADRV Byte; contains the absolute drive code (0 
through F for A through P) that CP/M is 
referencing for READ and WRITE operations. The 
SELDSK routine in the BIOSKRNL module obtains 
this value from |bhe BDOS and places it in @DRV. 
The absolute drive code is used to print error 
messages. 



@RDRV Byte; contains the relative drive code for READ 
and WRITE operations. The relative drive code 
is the UNIT number of the controller in a given 
disk I/O module. BIOSKRNL obtains the unit 
number from the XDPH. This is the actual drive 
code a driver should send to the controller. 



@TRK Word; contains the starting track for READ and 
WRITE. 



@SECT 



Word; contains the starting sector for READ and 
WRITE. 



@DMA 



Word; contains the starting disk transfer 
address. 



@DBNK 



Byte; contains the bank of the DMA buffer. 



@CNT Byte; contains the physical sector count for 
the operations that follow. 



(3CBNK 



Byte; contains the current bank for code 
execution . 



Several utility subroutines are defined in the BIOSKRNL.ASM 
module, as shown in Table 4-4. 



Table 4-4. Public Utility Subroutines in BIOSKRNL.ASM 



Utility 


Meaning 


?PMSG 


Print string starting at <HL> , stop at null 
(0). 


?PDEC 


Print binary number in decimal from HL. 


7PDERR 


Print disk error message header using current 
disk parameters: <CR><LF>BIOS Error on d: , T- 
nn , S-nn. 
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All BIOS entry points in the jump vector are declared as public 
for general reference by other BIOS modules, as shown in Table 4-5. 



Table 


4-5. Public Names in the BIOS Jump Vector 


Public Name 


Function 


7B00T 


Cold boot entry 


7WB00T 


Warm boot entry 


7C0NST 


Console input status 


? CON IN 


Console input 


7C0N0 


Console output 


7LIST 


List output 


7AUX0 


Auxiliary output 


7AUXI 


Auxiliary input 


7 HOME 


Home disk drive 


7SLDSK 


Select disk drive 


7STTRK 


Set track 


7STSEC 


Set sector 


7STDMA 


Set DMA address 


7 READ 


Read record 


7 WRITE 


Write record 


7LISTS 


List status 


7SCTRN 


Translate sector 


7C0N0S 


Console output status 


7AUXIS 


Auxiliary input status 


7AUX0S 


Auxiliary output status 


7DVTBL 


Return character device table address 


7DEVIN 


Initialize character device 


7DRTBL 


Return disk drive table address 


7MLTI0 


Set multiple sector count 


7FLUSH 


Flush deblocking buffers (not implemented) 


7M0V 


Move memory block 


7TIM 


Signal set or get time from clock 


7BNKSL 


Set bank for further execution 


7STBNK 


Set bank for DMA 


7XM0V 


Set banks for next move 



4.5 BOOT Module 

The BOOT module performs general system initialization, and 
loads and reloads the CCP. Table 4-6 shows the entry points of the 
BOOT module. 
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4.5 BOOT Module 



Table 4-6. BOOT Module Entry Points 



Module 



Meaning 



?INIT 



PLDCCP 



?RLCCP 



The BIOSKRNL module calls ?INIT during 
cold start to perform hardware 
initialization other than character and 
disk I/O. Typically, this hardware can 
include time-of-day clocks, interrupt 
systems, and special I/O ports used for 
bank selection. 

BIOSKRNL calls ?LDCCP during cold start to 
load the CCP into the TPA. The CCP can be 
loaded either from the system tracks of 
the boot device or from a file, at the 
discretion of the system implementor. In 
a banked system, you can place a copy of 
the CCP in a reserved area of another bank 
to increase the performance of the PRLCCP 
routine. 

BIOSKRNL calls PRLCCP during warm start to 
reload the CCP into the TPA. In a banked 
system, the CCP can be copied from an 
alternate bank to eliminate any disk 
access. Otherwise, the CCP should be 
loaded from either the system tracks of 
the boot device or from a file. 



4.6 Character I/O 

The CHARIO module handles all character device interfacing. 
The CHARIO module contains the character device definition table 
@CTBL, the character input routine PCI, the character output routine 
?C0, the character input status routine PCIST, the character output 
status routine PCOST, and the character device initialization 
routine PCINIT. 

The BIOS root module, BIOSKRNL. ASM, handles all character I/O 
redirection. This module determines the appropriate devices to 
perform operations and executes the actual operation by calling PCI, 
?C0, PCIST, and PCOST with the proper device number (s) . 

@CTBL is the external name for the structure CHRTBL described 
in Section 3 of this manual. @CTBL contains an 8-byte entry for 
each physical device defined by this BIOS. The table is terminated 
by a zero byte after the last entry. 

The first field of the character device table, @CTBL, is the 6- 
byte device name. This device name should be all upper-case, left- 
justified, and padded with ASCII spaces (20H) . 
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4.6 Character I/O 



The second field of @CTBL is 1 byte containing bits that 
indicate the type of device and its current mode, as shown in Table 
4-7. 





Table 4-7. Mode Bits 


Mode Bits 


Meaning 


00000001 


Input device (such as a keyboard) 


00000010 


Output device (such as a printer) 


00000011 


Input/output device (such as a terminal 




or modem) 


00000100 


Device has software-selectable baud 




rates 


00001000 


Device may use XON protocol 


00010000 


XON/XOFF protocol enabled 



The third field of @CTBL is 1 byte and contains the current 
baud rate for serial devices. The high-order nibble of this field 
is reserved for future use and should be set to zero. The low-order 
four bits contain the current baud rate as shown in Table 4-8. Many 
systems do not support all of these baud rates. 



Table 4-8 Baud Rates for Serial Devices 



Decimal 


Binary 


Baud Rate 





0000 


none 


1 


0001 


50 


2 


0010 


75 


3 


0011 


110 


4 


0100 


134.5 


5 


0101 


150 


6 


0110 


300 


7 


0111 


600 


8 


1000 


1200 


9 


1001 


1800 


10 


1010 


2400 


11 


1011 


3600 


12 


1100 


4800 


13 


1101 


7200 


14 


1110 


9600 


15 


1111 


19200 



Table 4-9 shows the entry points to the routines in the CHARIO 
module. The BIOSKRNL module calls these routines to perform 
machine-dependent character I/O. 
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Table 4-9. Character Device Labels 



Label 



Meaning 



PCI Character Device Input 

?CI is called with a device number in register 
B. It should wait for the next available input 
character, then return the character in 
register A. The character should be in 8-bit 
ASCII with no parity. 



?C0 Character Device Output 

?C0' is called with a device number in register 
B and a character in register C. It should 
wait until the device is ready to accept 
another character and then send the character. 
The character is in 8-bit ASCII with no parity. 



PCIST Character Device Input Status 

7CIST is called with a device number in 
register B. It should return with register A 
set to zero if the device specified has no 
input character ready; and should return with A 
set to OFFH if the device specified has an 
input character ready to be read. 



7C0ST Character Device Output Status 

?COST is called with a device number in 
register B. It should return with register A 
set to zero if the device specified cannot 
accept a character immediately, and should 
return with A set to OFFH if the device is 
ready to accept a character. 



7CINIT Character Device Initialization 

7CINIT is called for each of the 16 character 
devices, and initializes the devices. Register 
C contains the device number. The PCINIT 
routine initializes the physical character 
device specified in register C to the baud rate 
contained in the appropriate entry of the 
CHRTBL. You only need 'to supply this routine 
if I/O redirection has been implemented. It is 
referenced only by the DEVICE utility supplied 
with CP/M 3. 
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4.7 Disk I/O 

The separation of the disk I/O section of the BIOS into several 
modules allows you to support each particular disk controller 
independently from the rest of the system. A manufacturer can 
supply the code for a controller in object module form, and you can 
link it into any existing modular BIOS to function with other 
controllers in the system. 

The data structure called the Extended Disk Parameter Header, 
or XDPH, contains all the necessary information about a disk drive. 
BIOSKRNL.ASM locates the XDPH for a particular logical drive using 
the Drive Table. The XDPH contains the addresses of the READ, 
WRITE, initialization, and login routines. The XDPH also contains 
the relative unit number of the drive on the controller, the current 
media type, and the Disk Parameter Header (DPH) that the BDOS 
requires. Section 3 of this manual describes the Disk Parameter 
Header . 

The code to read and write from a particular drive is 
independent of the actual CP/M logical drive assignment, and works 
with the relative unit number of the drive on the controller. The 
position of the XDPH entry in the DRVTBL determines the actual CP/M 
3 drive code. 



4.7.1 Disk I/O Structure 

The BIOS requires a DRVTBL module to locate the disk driver. 
It also requires a disk module for each controller that is 
supported. 

The drive table module, DRVTBL, contains the addresses of each 
XDPH defined in the system. Each XDPH referenced in the DRVTBL must 
be declared external to link the table with the actual disk modules. 

The XDPHs are the only public entry points in the disk I/O 
modules. The root module references the XDPHs to locate the actual 
I/O driver code to perform sector READS and WRITES. When the READ 
and WRITE routines are called, the parameters controlling the READ 
or WRITE operation are contained in a series of global variables 
that are declared public in the root module. 

4.7.2 Drive Table Module (DRVTBL) 

The drive table module, DRVTBL, defines the CP/M absolute drive 
codes associated with the physical disks. 

The DRVTBL module contains one public label, @DTBL. @DTBL is a 
16-word table containing the addresses of up to 16 XDPH's. Each 
XDPH name must be declared external in the DRVTBL. The first entry 
corresponds to drive A, and the last to drive P. You must set an 
entry to if the corresponding drive is undefined. Selecting an 
undefined drive causes a BDOS SELECT error. 
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4.7 Disk I/O 



4.7.3 Extended Disk Parameter Headers (XDpHs) 

An Extended Disk Parameter Header (XDPH) consists of a prefix 
and a regular Disk Parameter Header as described in Section 3. The 
label of a XDPH references the start of the DPH. The fields of the 
prefix are located at relative offsets from the XDPH label. 

The XDPHs for each unit of a controller are the only entry 
points in a particular disk drive module. They contain both the DPH 
for the drive and the addresses of the various action routines for 
that drive, including READ, WRITE, and initialization. Figure 4-1 
below shows the format of the Extended Disk parameter Header. 



start of 
< — regular DPH 



ADDRESS LOW BYTE HIGH BYTE 

7 8 15 

XDPH- 10 
XDPH-8 
XDPH -6 
XDPH-4 
XDPH- 2 
XDPH+0 
XDPH+2 
XDPH+4 
XDPH+6 
XDPH+8 
XDPH+10 
XDPH+12 
XDPH+14 
XDPH+16 
XDPH+18 
XDPH+20 
XDPH+2 2 
XDPH+2 4 

Figure 4-1. XDPH Format 
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addr of sector WRITE 


addr of sector READ 


addr of drive LOGIN 


addr of drive INIT 


unit 


type 


addr of translate table 


























Media Flag 





addr < 


Df DPB 


addr c 


)f CSV 


addr c 


>f ALV 


addr c 


)f DIRBCB 


addr c 


>f DTABCB 


addr c 


>f HASH 


hash bank 
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4.7 Disk I/O 



Table 4-10 describes the fields of each Extended Disk Parameter 
Header . 



Table 4-10. Fields of Each XDPH 



Field 


Meaning 


WRITE 


The WRITE word contains the address of the 
sector WRITE routine for the drive. 


READ 


The READ word contains the address of the 
sector READ routine for the drive. 


LOGIN 


The LOGIN word contains the address of the 
LOGIN routine for the drive. 


INIT 


The INIT word contains the address of the 
first-time initialization code for the 
drive . 


UNIT 


The UNIT byte contains the drive code 
relative to the disk controller. This is 
the value placed in @RDRV prior to calling 
the READ, WRITE, and LOGIN entry points of 
the drive. 


TYPE 


The TYPE byte is unused by the BIOS root, 
and is reserved for the driver to keep the 
current density or media type to support 
multiple- format disk subsystems. 


regular DPH The remaining fields of the XDPH comprise 
a standard DPH, as discussed in Section 3 
of this manual. 



4.7.4 Subroutine Entry Points 

The pointers contained in the XDPH reference the actual code 
entry points to a disk driver module. These routines are not 
declared public. Only the XDPH itself is public. The BIOS root 
references the XDPHs only through the @DTBL. Table 4-11 shows the 
BIOS subroutine entry points. 
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Table 4-11. Subroutine Entry Points 



Entry Point 



Meaning 



WRITE When the WRITE routine is called, the 
address of the XDPH is passed in registers 
DE . The parameters for the WRITE 
operation are contained in the public 
variables @ADRV, @RDRV, @TRK, @SECT, @DMA, 
and @DBNK. The WRITE routine should 
return an error code in register A. The 
code 00 means a successful operation, 01 
means a permanent error occurred, and 02 
means the drive is write-protected if that 
feature is supported. 

READ When the READ routine is called, the 
address of the XDPH is contained in 
registers DE. The parameters for the READ 
operation are contained in the public 
variables @ADRV, @RDRV, @TRK, @SECT, @DMA, 
and @DBNK. The READ routine should return 
an error code in register A. A code of 00 
means a successful operation and 01 means 
a permanent error occurred. 

LOGIN The LOGIN routine is called before the 
BDOS logs into the drive, and allows the 
automatic determination of density. The 
LOGIN routine can alter the various 
parameters in the DPH, including the 
translate table address (TRANS) and the 
Disk Parameter Block (DPB) . The LOGIN 
routine can also set the TYPE byte. On 
single media type systems, the LOGIN 
routine can simply return. When LOGIN is 
called, the registers DE point to the XDPH 
for this drive. 

INIT The BOOT entry of the BIOSKRNL module 
calls each INIT routine during cold start 
and prior to any other disk accesses. 
INIT can perform any necessary hardware 
initialization, such as setting up the 
controller and interrupt vectors, if any. 



4.7.5 Error Handling and Recovery 

The READ and WRITE routines should perform several retries of 
an operation that produces an error. If the error is related to a 
seek operation or a record not found condition, the retry routine 
can home or restore the drive, and then seek the correct track. The 
exact sequence of events is hardware- dependent. 
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When a nonrecoverable error occurs, the READ or WRITE routines 
can print an error message informing the operator of the details of 
the error. The BIOSKRNL module supplies a subroutine, 7PDERR, to 
print a standard BIOS error message header. This routine prints the 
following message: 

BIOS Err on D: T-nn S-nn 

where D: is the selected drive, and T-nn and S-nn display the track 
and sector number for the operation. The READ and WRITE routines 
should print the exact cause of the error after this message, such 
as Not Ready, or Write Protect. The driver can then ask the 
operator if additional retries are desired, and return an error code 
to the BDOS if they are not. 

However, if the @ERMDE byte in the System Control Block 
indicates the BDOS is returning error codes to the application 
program without printing error messages, the BIOS should simply 
return an error without any message. 

4.7.6 Multiple Section I/O 

The root module global variable @CNT contains the multisector 
count. Refer to Sections 2.5 and 3.4.3 for a discussion of the 
considerations regarding multirecord I/O. 

4.8 MOVE Module 

The MOVE Module performs memory- to- memory block moves and 
controls bank selection. The ?MOVE and 7XM0VE entry points 
correspond directly to the MOVE and XMOVE jump vector routines 
documented in Section 3. Table 4-12 shows the entry points for the 
MOVE module. 
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Table 4-12. Move Module Entry Points 



Entry Point Meaning 



?MOVE Memory- to- memory move 



?MOVE is called with the source address for 
the move in register DE, the destination 
address in register HL, and the byte count in 
register BC. If ?XMOVE has been called since 
the last call to ?MOVE, an interbank move must 
be performed. On return, registers HL and DE 
must point to the next bytes after the MOVE. 
This routine can use special DMA hardware for 
the interbank move capability, and can use the 
Z80 LDIR instruction for intrabank moves. 



?XMOVE Set banks for one following ?MOVE 



7XM0VE is passed to the source bank in 
register B and the destination bank in 
register C. Interbank moves are only invoked 
if the DPHs specify deblocking buffers in 
alternate banks. 7XM0VE only applies to one 
call to ?MOVE. 



?BANK Set bank for execution 



?BANK is called with the bank address in 
register A. This bank address has already 
been stored in @CBNK for future reference. 
All registers except A must be maintained upon 
return. 



4.9 Linking Modules into the BIOS 

The following lines are examples of typical link commands to 
build a modular BIOS ready for system generation with GENCPM: 

LINK BNKBI0S3[b]=BNKBI0S,SCB, BOOT, CHARIO, MOVE, DRVTBL,<disk_modules> 
LINK BI0S3[b]=BI0S,SCB, BOOT, CHARIO, MOVE, DRVTBL, <disk_modules> 

End of Section 4 
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Section 5 
System Generation 



This section describes the use of the GENCPM utility to create 
a memory image CPM3.SYS file containing the elements of the CP/M 3 
operating system. This section also describes customizing the 
LDRBIOS portion of the CPMLDR program, and the operation of CPMLDR 
to read the CPM3.SYS file into memory. Finally, this section 
describes the procedure to follow to boot CP/M 3. 

In the nonbanked system, GENCPM creates the CPM3.SYS file from 
the BD0S3.SPR and your customized BI0S3.SPR files. In the banked 
system, GENCPM creates the CPM3.SYS file from the RESBD0S3.SPR file, 
the BNKBD0S3.SPR file, and your customized BNKBI0S3.SPR file. 

If your BIOS contains a segment that can reside in banked 
memory, GENCPM separates the code and data in BNKBI0S3.SPR into a 
banked portion which resides in Bank just below common memory, and 
a resident portion which resides in common memory. 

GENCPM relocates the system modules, and can allocate physical 
record buffers, allocation vectors, checksum vectors, and hash 
tables as requested in the BIOS data structures. GENCPM accepts its 
command input from a file, GENCPM.DAT, or interactively from the 
console. 



5.1 GENCPM Utility 

Syntax: 

GENCPM {AUTO I AUTO DISPLAY} 
Purpose: 



GENCPM creates a memory image CPM3.SYS file, containing the 
CP/M 3 BDOS and customized BIOS. The GENCPM utility performs late 
resolution of intermodule references between system modules. GENCPM 
can accept its command input interactively from the console or from 
a file GENCPM.DAT. 

In the nonbanked system, GENCPM creates a CPM3.SYS file from 
the BD0S3.SPR and BI0S3.SPR files. In the banked system, GENCPM 
creates the CPM3.SYS file from the RESBD0S3.SPR, the BNKBD0S3.SPR 
and the BNKBI0S3.SPR files. Remember to back up your CPM3.SYS file 
before executing GENCPM, because GENCPM deletes any existing 
CPM3.SYS file before it generates a new system. 
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Input Files; 

Banked System Nonbanked System 

BNKBI0S3.SPR BI0S3.SPR 

RESBD0S3.SPR BD0S3.SPR 

BNKBD0S3.SPR 

Optionally GENCPM.DAT 

Output File; 

CPM3.SYS 

Optionally GENCPM.DAT 

GENCPM determines the location of the system modules in memory 
and, optionally, the number of physical record buffers allocated to 
the system. GENCPM can specify the location of hash tables 
requested by the Disk Parameter Headers (DPHs) in the BIOS. GENCPM 
can allocate all required disk buffer space and create all the 
required Buffer Control Blocks (BCBs) . GENCPM can also create 
checksum vectors and allocation vectors. 

GENCPM can get its input from a file GENCPM.DAT. The values in 
the file replace the default values of GENCPM. If you enter the 
AUTO parameter in the command line GENCPM gets its input from the 
file GENCPM.DAT and generates a new system displaying only its sign- 
on and sign-off messages on the console. If AUTO is specified and a 
GENCPM.DAT file does not exist on the current drive, GENCPM reverts 
to manual generation. 

If you enter the AUTO DISPLAY parameter in the command line, 
GENCPM automatically generates a new system and displays all 
questions on the console. If AUTO DISPLAY is specified and a 
GENCPM.DAT file does not exist on the current drive, GENCPM reverts 
to manual generation. If GENCPM is running in AUTO mode and an 
error occurs, it reverts to manual generation and starts from the 
beginning. 

The GENCPM.DAT file is an ASCII file of variable names and 
their associated values. In the following discussion, a variable 
name in the GENCPM.DAT file is referred to as a Question Variable. 
A line in the GENCPM.DAT file takes the following general form: 

Question Variable = value | ? | ? value <CR><LF> 

value = #decimal value 

or hexadecimal value 
or drive letter (A - P) 
or Yes, No, Y, or N 



All Information Presented Here is Proprietary to Digital Research 

88 



CP/M 3 System Guide 5.1 The GENCPM Utility 

You can specify a default value by following a question mark 
with the appropriate value, for example ?A or ?25 or ?Y. The 
question mark tells GENCPM to stop and prompt the user for input, 
then continue automatically. At a ?value entry, GENCPM displays the 
default value and stops for verification. 

The following pages display GENCPM questions. The items in 
parentheses are the default values. The Question Variable 
associated with the question is shown below the explanation of the 
answers to the questions. 

Program Questions: 

Use GENCPM.DAT for defaults (Y) ? 

Enter Y - GENCPM gets its default values from the file 
GENCPM.DAT. 

Enter N - GENCPM uses the built-in default values. 

No Question Variable is associated with this question. 

Create a new GENCPM.DAT file (N) ? 

Enter N - GENCPM does not create a new GENCPM.DAT file. 

Enter Y - After GENCPM generates the new CPM3.SYS file it 
creates a new GENCPM.DAT file containing the default 
values . 

Question Variable: CRDATAF 

Display Load Table at Cold Boot (Y) ? 

Enter Y - On Cold Boot the system displays the load table 
containing the filename, filetype, hex starting address, 
length of system modules, and the TPA size. 

Enter N - System displays only the TPA size on cold boot. 

Question Variable: PRTMSG 

Number of console columns (#80) ? 

Enter the number of columns (characters-per-line) for your 
console. 

A character in the last column must not force a new line 
for console editing in CP/M 3. If your terminal forces a 
new line automatically, decrement the column count by one. 

Question Variable: PAGWID 
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Number of lines per console page (#24) ? 

Enter the number of the lines per screen for your console. 

Question Variable: PAGLEN 

Backspace echoes erased character (N) ? 

Enter N - Backspace (Ctrl-H, 08H) moves back one column and 
erases the previous character. 

Enter Y - Backspace moves forward one column and displays 
the previous character. 

Question Variable: BACKSPC 

Rubout echoes erased character (Y) ? 

Enter Y - Rubout (7FH) moves forward one column and 
displays the previous character. 

Enter N - Rubout moves back one column and erases the 
previous character. 

Question Variable: RUBOUT 
Initial default drive (A:) ? 

Enter the drive code the prompt is to display at cold boot. 

Question Variable: BOOTDRV 

Top page of memory (FF) ? 

Enter the page address that is to be the top of the 
operating system. OFFH is the top of a 64K system. 

Question Variable: MEMTOp 
Bank- switched memory (Y) ? 

Enter Y - GENCPM uses the banked system files. 

Enter N - GENCPM uses the nonbanked system files. 

Question Variable: BNKSWT 

Common memory base page (CO) ? 

This question is displayed only if you answered Y to the 
previous question. Enter the page address of the start of 
common memory. 

Question Variable: COMBAS 
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Long error messages (Y) ? 

This question is displayed only if you answered Y to bank- 
switched memory. 

Enter Y - CP/M 3 error messages contain the BDOS function 
number and the name of the file on which the operation was 
attempted. 

Enter N - CP/M 3 error messages do not display the function 
number or file. 

Question Variable: LERROR 

Double allocation vectors (Y) ? 

This question is displayed only if you answered N to bank- 
switched memory. For more information about double 
allocation vectors, see the definition of the Disk 
Parameter Header ALV field in Section 3. 

Enter Y - GENCPM creates double-bit allocation vectors for 
each drive. 

Enter N - GENCPM creates single-bit allocation vectors for 
each drive. 

Question Variable: DBLALV 

Accept new system definition (Y) ? 

Enter Y - GENCPM proceeds to the next set of questions. 

Enter N - GENCPM repeats the previous questions and 
displays your previous input in the default parentheses. 
You can modify your answers. 

No Question Variable is associated with this question. 

Number of memory segments (#3) ? 

GENCPM displays this question if you answered Y to bank- 
switched memory. 

Enter the number of memory segments in the system. Do not 
count common memory or memory in Bank 1, the TPA bank, as a 
memory segment. A maximum of 16 (0 - 15) memory segments 
are allowed. The memory segments define to GENCPM the 
memory available for buffer and hash table allocation. Do 
not include the part of Bank that is reserved for the 
operating system. 

Question Variable: NUMSEGS 
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CP/M 3 Base, size, bank (8E,32,00) 

Enter memory segment table: 
Base, size, bank (00,8E,00) ? 
Base, size, bank (00, CO, 02) ? 
Base, size, bank (00, CO, 03) ? 

Enter the base page, the length, and the bank of the memory 
segment. 

Question Variable: MEMSEG0# where # = to F hex 

Accept new memory segment table entries (Y) ? 

Enter Y - GENCPM displays the next group of questions. 

Enter N - GENCPM displays the memory segment table 
definition questions again. 

No Question Variable is associated with this question. 

Setting up directory hash tables: 

Enable hashing for drive d: (Y) : 

GENCPM displays this question if there is a Drive Table and 
if the DPHs for a given drive have an 0FFFEH in the hash 
table address field of the DPH. The question is asked for 
every drive d: defined in the BIOS. 

Enter Y - Space is allocated for the Hash Table. The 
address and bank of the Hash Table is entered into the DPH. 

Enter N - No space is allocated for a Hash Table for that 
drive . 

Question Variable: HASHDRVd where d = drives A-P. 

Setting up Blocking/Deblocking buffers: 

GENCPM displays the next set of questions if either or both 
the DTABCB field or the DIRBCB field contain 0FFFEH. 

Number of directory buffers for drive d: (#1) ? 10 

This question appears only if you are generating a banked 
system. Enter the number of directory buffers to allocate 
for the specified drive. In a banked system, directory 
buffers are allocated only inside Bank 0. In a nonbanked 
system, one directory buffer is allocated above the BIOS. 

Question Variable: NDIRRECd where d = drives A-P. 
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Number of data buffers for drive d: (#1) ? 1 

This question appears only if you are generating a Banked 
system. Enter the number of data buffers to allocate for 
the specified drive. In a banked system, data buffers can 
only be allocated outside Bank 1, and in common. You can 
only allocate data buffers in alternate banks if your BIOS 
supports interbank moves. In a nonbanked system, data 
buffers are allocated above the BIOS. 

Question Variable: NDTARECd where d = drives A-P. 

Share buffer (s) with which drive (A:) ? 

• This question appears only if you answered zero to either 
of the above questions. Enter the drive letter (A-P) of 
the drive with which you want this drive to share a buffer. 

Question Variable: ODIRDRVd for directory records where d 
= drives A-P. 

Question Variable: ODTADRVd for data records where d = 
drives A-P. 

Allocate buffers outside of Commom (N) ? 

This question appears if the BIOS XMOVE routine is 
implemented. 

Answer Y - GENCPM allocates data buffers outside of common 
and Bank 0. 

Answer N - GENCPM allocates data buffers in common. 

Question Variable: ALTBNKSd where d = drives A-P. 

Overlay Directory buffer for drive d: (Y) ? 

This question appears only if you are generating a 
nonbanked system. 

Enter Y - this drive shares a directory buffer with another 
drive. 

Enter N - GENCPM allocates an additional directory buffer 
above the BIOS. 

Question Variable: OVLYDIRd where d = drives A-P. 
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Overlay Data buffer for drive d: (Y) ? 

This question appears only if you are generating a 
non banked system. 

Enter Y - this drive shares a data buffer with another 
drive. 

Enter N - GENCPM allocates an additional data buffer above 
the BIOS. 

Question Variable: OVLYDTAd for directory records where d 
= drives A-P. 

Accept new buffer definitions (Y) ? 

Enter Y - GENCPM creates the CPM3.SYS file and terminates. 

Enter N - GENCPM redisplays all of the buffer definition 
questions. 

No Question Variable is associated with this question. 

Examples: 

The following section contains examples of two system 
generation sessions. If no entry follows a program question, assume 
RETURN was entered to select the default value in parentheses. 
Entries different from the default appear after the question mark. 



EXAMPLE OF CONTENTS OF GENCPM.DAT FILE 

combas = cO <CR> 
lerror = ? <CR> 
numsegs = 3 <CR> 
memsegOO = 00,80,00 <CR> 
memsegOl = 0d,b3,02 <CR> 
memsegOf = ?00,c0,10 <CR> 
hashdrva = y <CR> 
hashdrvd = n <CR> 
ndirreca = 20 <CR> 
ndtarecf = 10 <CR> 



EXAMPLE OF SYSTEM GENERATION WITH BANKED MEMORY 

A> GENCPM 

CP/M 3.0 System Generation 
Copyright (C) 1982, Digital Research 

Default entries are shown in (parens). 

Default base is Hex, precede entry with # for decimal 
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Use GENCPM.DAT for defaults (Y) ? 

<•* .-<*-- - ^«.. r"n<Mr»T»M r»J\T> fi'l n fM\ ■> 

Display Load Map at Cold Boot (Y) ? 

Number of console columns (#80) ? 
Number of lines in console page (#24) ? 
Backspace echoes erased character (N) ? 
Rubout echoes erased character (N) ? 

Initial default drive (A:) ? 

Top page of memory (FF) ? 
Bank switched memory (Y) ? 
Common memory base page (CO) ? 

Long error messages (Y) ? 

Accept new system definition (Y) ? 

Setting up Allocation vector for drive A: 
Setting up Checksum vector for drive A: 
Setting up Allocation vector for drive B: 
Setting up Checksum vector for drive B: 
Setting up Allocation vector for drive C: 
Setting up Checksum vector for drive C: 
Setting up Allocation vector for drive D: 
Setting up Checksum vector for drive D: 

*** Bank 1 and Common are not included *** 
*** in the memory segment table. *** 

Number of memory segments (#3) ? 

CP/M 3 Base, size, bank (8B,35,00) 

Enter memory segment table: 
Base, size, bank (00,8B,00) ? 
Base, size, bank (OD,B3,02) ? 
Base, size, bank (00, CO, 03) ? 

CP/M 3 Sys 8B00H 3500H Bank 00 

Memseg No. 00 0000H 8B00H Bank 00 

Memseg No. 01 0D00H B300H Bank 02 

Memseg No. 02 0000H C000H Bank 03 

Accept new memory segment table entries (Y) ? 

Setting up directory hash tables: 
Enable hashing for drive A: (Y) ? 
Enable hashing for drive B: (Y) ? 
Enable hashing for drive C: (Y) ? 
Enable hashing for drive D: (Y) ? 
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Setting up Blocking/Deblocking buffers: 

The physical record size is 0200H: 

Available space in 256 byte pages: 

TPA = 00F4H, Bank = 008BH, Other banks = 0166H 

Number of directory buffers for drive A: (#32) ? 

Available space in 256 byte pages: 

TPA = 00F4H, Bank = 0049H, Other banks = 0166H 

Number of data buffers for drive A: (#2) ? 
Allocate buffers outside of Common (N) ? 

Available space in 256 byte pages: 

TPA = 00F0H, Bank = 0049H, Other banks = 0166H 

Number of directory buffers for drive B: (#32) ? 

Available space in 256 byte pages: 

TPA = 00F0H, Bank = 0007H, Other banks = 0166H 

Number of data buffers for drive B: (#0) ? 
Share buffer (s) with which drive (A:) ? 

The physical record size is 0080H: 

Available space in 256 byte pages: 

TPA = 00F0H, Bank = 0007H, Other banks = 0166H 

Number of directory buffers for drive C: (#10) ? 

Available space in 256 byte pages: 

TPA = 00F0H, Bank = 0001H, Other banks = 0166H 

Number of directory buffers for drive D: (#0) ? 
Share buffer (s) with which drive (C:) ? 

Available space in 256 byte pages: 

TPA = 00F0H, Bank = 0001H, Other banks = 0166H 

Accept new buffer definitions (Y) ? 

BNKBIOS3 SPR F600H 0600H 

BNKBIOS3 SPR B100H 0F00H 

RESBDOS3 SPR F000H 0600H 

BNKBDOS3 SPR 8700H 2A00H 

*** CP/M 3.0 SYSTEM GENERATION DONE *** 

In the preceding example GENCPM displays the resident portion of 
BNKBIOS3.SPR first, followed by the banked portion. 
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EXAMPLE OF SYSTEM GENERATION WITH NONBANKED MEMORY 

A> GENCPM 

CP/M 3.0 System Generation 
Copyright (C) 1982, Digital Research 

Default entries are shown in (parens) . 

Default base is Hex, precede entry with # for decimal 

Use GENCPM.DAT for defaults (Y) ? 

Create a new GENCPM.DAT file (N) ? 

Display Load Map at Cold Boot (Y) ? 

Number of console columns (#80) ? 
Number of lines in console page (#24) ? 
Backspace echoes erased character (N) ? 
Rubout echoes erased character (N) ? 

Initial default drive (A:) ? 

Top page of memory (FF) ? 
Bank switched memory (Y) ? N 

Double allocation vectors (Y) ? 

Accept new system definition (Y) ? 

Setting up Blocking/Deblocking buffers: 

The physical record size is 0200H: 

Available space in 256 byte pages: 
TPA = 00D8H 

*** Directory buffer required *** 
*** and allocated for drive A: *** 

Available space in 256 byte pages: 
TPA = 00D5H 

Overlay Data buffer for drive A: (Y) ? 

Available space in 256 byte pages: 
TPA = 00D5H 

Overlay Directory buffer for drive B: (Y) ? 
Share buff er (s) with which drive (A:) ? 

Available space in 256 byte pages: 
TPA = 00D5H 
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Overlay Data buffer for drive B: (Y) ? 
Share buffer (s) with which drive (A:) ? 

The physical record size is 0080H: 

Available space in 256 byte pages: 
TPA = 00D5H 

Overlay Directory buffer for drive C: (Y) ? 
Share buffer (s) with which drive (A:) ? 

Available space in 256 byte pages: 
TPA = 00D5H 

Overlay Directory buffer for drive D: (Y) ? 
Share buff er (s) with which drive (C: ) ? 

Available space in 256 byte pages: 
TPA = 00D5H 



Accept new buffer definitions (Y) ? 

BI0S3 SPR F300H 0B00H 
BDOS3 SPR D600H 1D00H 

*** CP/M 3.0 SYSTEM GENERATION DONE *** 

A> 



5.2 Customizing the CPMLDR 

The CPMLDR resides on the system tracks of a CP/M 3 system 
disk, and loads the CPM3.SYS file into memory to cold start the 
system. CPMLDR contains the LDRBDOS supplied by Digital Research, 
and must contain your customized LDRBIOS. 

The system tracks for CP/M 3 contain the customized Cold Start 
Loader, CPMLDR with the customized LDRBIOS, and possibly the CCP. 

The COPYSYS utility places the Cold Start Loader, the CPMLDR, 
and optionally the CCP on the system tracks, as shown in Table 5-1. 
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Table 5-1. Sample CP/M 3 System Track Organization 



Track 


Sector 


Page 


Memory Address 


CP/M 3 Module Name 


00 


01 




Boot Address 


Cold Start Loader 


00 


02 


00 


0100H 


CPMLDR 
and 


00 


21 


09 


0A80H 


LDRBDOS 


00 


22 


10 


0B00H 


LDRBIOS 


00 


26 


12 


0D00H 


and 


01 


01 


12 


0D80H 




01 


26 


25 


1A00H 


CCP 



Typically the Cold Start Loader is loaded into memory from 
Track 0, Sector 1 of the system tracks when the reset button is 
depressed. The Cold Start Loader then loads CPMLDR from the system 
tracks into memory. 

Alternatively, if you are starting from an existing CP/M 2 
system, you can run CPMLDR.COM as a transient program. CP/M 2 loads 
CPMLDR.COM into memory at location 100H. CPMLDR then reads the 
CPM3.SYS file from User on drive A and loads it into memory. 

Use the following procedure to create a customized CPMLDR.COM 
file, including your customized LDRBIOS: 

1) Prepare a LDRBIOS. ASM file. 

2) Assemble the LDRBIOS file with RMAC to produce a LDRBIOS. REL 
file. 

3) Link the supplied CPMLDR. REL file with the LDRBIOS. REL file 
you created to produce a CPMLDR.COM file. 

A>LINK CPMLDR [L100]=CPMLDR, LDRBIOS 

Replace the address 100 with the load address to which your 
boot loader loads CPMLDR.COM. You must include a bias of 
100H bytes for buffer space when you determine the load 
address. 
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The CPMLDR requires a customized LDRBIOS to perform disk input 
and console output. The LDRBIOS is essentially a nonbanked BIOS. 
The LDRBIOS has the same JMP vector as the regular CP/M 3 BIOS. The 
LDRBIOS is called only to perform disk reads (READ) from one drive, 
console output (CONOUT) for sign-on messages, and minimal system 
initialization. 

The CPMLDR calls the BOOT entry point at the beginning of the 
LDRBIOS to allow it to perform any necessary hardware 
initialization. The BOOT entry point should return to CPMLDR 
instead of loading and branching to the CCP, as a BIOS normally 
does. Note that interrupts are not disabled when the LDRBIOS BOOT 
routine is called. 

Test your LDRBIOS completely to ensure that it properly 
performs console character output and disk reads. Check that the 
proper tracks and sectors are addressed on all reads and that data 
is transferred to the proper memory locations. 

You should assemble the LDRBIOS. ASM file with a relocatable 
origin of OOOOH. Assemble the LDRBIOS with RMAC to produce a 
LDRBIOS. REL file. Link the LDRBIOS. REL file with the CPMLDR. REL 
file supplied by Digital Research to create a CPMLDR.COM file. Use 
the L option in LINK to specify the load origin (address) to which 
the boot loader on track sector 1 loads the CPMLDR.COM file. 

Unnecessary BIOS functions can be deleted from the LDRBIOS to 
conserve space. There is one absolute restriction on the length of 
the LDRBIOS: it cannot extend above the base of the banked portion 
of CP/M 3. (GENCPM lists the base address of CP/M 3 in its load 
map.) If you plan to boot CP/M 3 from standard, single-density, 
eight- inch floppy disks, your CPMLDR must not be longer than 1980H 
to place the CPMLDR.COM file on two system tracks with the boot 
sector. If the CCP resides on the system tracks with the Cold Start 
Loader and CPMLDR, the combined lengths must not exceed 1980H. 

5.3 The CPMLDR Utility 

Syntax: 

CPMLDR 
Purpose: 



CPMLDR loads the CP/M 3 system file CPM3.SYS into Bank and 
transfers control to the BOOT routine in the customized BIOS. You 
can specify in GENCPM for CPMLDR to display a load table containing 
the names and addresses of the system modules. 

The CPM3.SYS file contains the CP/M 3 BDOS and customized BIOS. 
The file CPM3.SYS must be on drive A in USER 0. You can execute 
CPMLDR under SID™ or DDT™ to help debug the BIOS. A $B in the 
default File Control Block (FCB) causes CPMLDR to execute a RST 7 
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5.3 The CPMLDR Utility 



(SID breakpoint) just before jumping to the CP/M 3 Cold Boot BIOS 
entry point. 

Tnnufc Pilot 



CPM3.SYS 
Examples: 



A> CPMLDR 

CP/M V3.0 Loader 

Copyright (C) 1982, Digital Research 

BNKBI0S3 SPR F600H 0A00H 
BNKBI0S3 SPR BBOOH 0500H 



RESBDOS3 SPR F100H 
BNKBDOS3 SPR 9A00H 

60K TPA 
A> 



0500H 
2100H 



In the preceding example, CPMLDR displays its name and version 
number, the Digital Research copyright message, and a four-column 
load table containing the filename, filetype, hex starting address, 
and length of the system modules. CPMLDR completes its sign-on 
message by indicating the size of the Transient Program Area (TPA) 
in kilobytes. The CCP then displays the system prompt, A> . 

5.4 Booting CP/M 3 

The CP/M 3 cold start operation loads the CCP, BDOS, and BIOS 
modules into their proper locations in memory and passes control to 
the cold start entry point (BIOS Function 0: BOOT) in the BIOS. 
Typically, a PROM-based loader initiates a cold start by loading 
sector on track 1 of the system tracks into memory and jumping to 
it. This first sector contains the Cold Start Loader. The Cold 
Start Loader loads the CPMLDR.COM program into memory and jumps to 
it. CPMLDR loads the CPM3.SYS file into memory and jumps to the 
BIOS cold start entry point. 
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To boot the CP/M 3 system, use the following procedure: 

1) Create the CPM3.SYS file. 

2) Copy the CPM3.SYS file to the boot drive. 

3) Create a CPMLDR.COM for your machine. 

4) Place the CPMLDR.COM file on your system tracks using SYSGEN 
with CP/M 2 or COPYSYS with CP/M 3. The boot loader must 
place the CPMLDR.COM file at the address at which it 
originated. If CPMLDR has been linked to load at 100H, you 
can run CPMLDR under CP/M 2. 

The COPYSYS utility handles initialization of the system 
tracks. The source of COPYSYS is included with the standard CP/M 3 
system because you need to customize COPYSYS to support nonstandard 
system disk formats. COPYSYS copies the Cold Start Loader, the 
CPMLDR.COM file, and optionally the CCP to the system tracks. Refer 
to the COPYSYS. ASM source file on the distribution disk. 

End of Section 5 



All Information Presented Here is Proprietary to Digital Research 

102 



Section 6 
Debugging the BIOS 



This section describes a sample debugging session for a 
nonbanked CP/M 3 BIOS. You must create and debug your nonbanked 
system first, then bring up the banked system. Note that your 
system probably displays addresses that differ from the addresses in 
the following example. 

You can use SID, Digital Research's Symbolic Debugger Program, 
running under CP/M 2.2, to help debug your customized BIOS. The 
following steps outline a sample debugging session. 

1) Determine the amount of memory available to CP/M 3 when the 
debugger and CP/M 2.2 are in memory. To do this, load the 
debugger under CP/M 2.2 and list the jump instruction at 
location 0005H. In the following example of a 64K system, 
C500 is the base address of the debugger, and also the 
maximum top of memory that you can specify in GENCPM for 
your customized CP/M 3 system. 

A>SID 

CP/M 3 SID - Version 3.0 

#L5 

0005 JMP C500 



2) Running under CP/M 2.2, use GENCPM to generate a CPM3.SYS 
file, which specifies a top of memory that is less than the 
base address of the debugger, as determined by the previous 
step. Allow at least 256K bytes for a patch area. In this 
example, you can specify C3 to GENCPM as the top of memory 
for your CP/M 3 system. 



A> 
GENCPM 



Top page of memory (FF) ? 
C3 
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3) Now you have created a system small enough to debug under 
SID. Use SID to load the CPMLDR.COM file, as shown in the 
following example: 

A>SID CPMLDR.COM 
CP/M 3 SID - Version 3.0 
NEXT MSZE PC END 
0E80 0E80 0100 D4FF 



4) Use the I command in SID, as shown in the next example, to 
place the characters $B into locations 005DH and 005EH of 
the default FCB based at 005CH. The $B causes CPMLDR.COM 
to break after loading the CPM3.SYS file into memory. 

#I$B 



5) Transfer control to CPMLDR using the G command: 

#G 

At this point, the screen clears and the following 
information appears: 

CP/M V3.0 LOADER 

Copyright (c) 1982, Digital Research 

BI0S3 SPR AAOO 0B00 
BD0S3 SPR 8B00 1F00 

34K TPA 

* 01A9 



6) With the CP/M 3 system in the proper location, you can set 
passpoints in your BIOS. Use the L command with the 
address specified as the beginning of the BIOS by the 
CPMLDR load table as shown in step 5 above. This L command 
causes SID to display the BIOS jump vector which begins at 
that address. The jump vector indicates the beginning 
address of each subroutine in the table. For example, the 
first jump instruction in the example below is to the Cold 
Boot subroutine. 

#LAA00 
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The output from your BIOS might look like this: 
JMP AA6 8 

TMT> A HOP 

JMP ABA4 
JMP ABAF 
JMP ABCA 



7) Now set a passpoint in the Cold BOOT routine. Use the P 
command with an address to set a passpoint at that address. 

#PAA6 8 

8) Continue with the CPMLDR.COM program by entering the G 
command, followed by the address of Cold Boot, the first 
entry in the BIOS jump vector. 

#GAA00 

9) In response to the G command, the CPMLDR transfers control 
to the CP/M 3 operating system. If you set a passpoint in 
the Cold BOOT routine, the program stops executing, control 
transfers to SID, and you can begin tracing the BOOT 
routine. 

10) When you know the BOOT routine is functioning correctly, 
enter passpoints for the other routines you want to trace, 
and begin tracing step by step to determine the location of 
problems. 

Refer to the Digital Research Symbolic Instruction Debugger 
User 1 s Guide (SID) in the Programmer ' s Utilities Guide for the CP/M 
Family of Operating Systems for a discussion of all the SID 
commands. 



End of Section 6 
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Appendix A 
Removable Media Considerations 



All disk drives under CP/M 3 are classified as either permanent 
or removable. In general, removable drives support media changes; 
permanent drives do not. Setting the high-order bit in the CKS 
field in a drive's Disk Parameter Block (DPB) marks the drive as a 
permanent drive. 

The BDOS file system distinguishes between permanent and 
removable drives. If a drive is permanent, the BDOS always accepts 
the contents of physical record buffers as valid. In addition, it 
also accepts the results of hash table searches on the drive. 

On removable drives, the status of physical record buffers is 
more complicated. Because of the potential for media change, the 
BDOS must discard directory buffers before performing most directory 
related BDOS function calls. This is required because the BDOS 
detects media changes by reading directory records. When it reads a 
directory record, the BDOS computes a checksum for the record, and 
compares the checksum to the currently stored value in the drive's 
checksum vector. If the checksum values do not match, the BDOS 
assumes the media has changed. Thus, the BDOS can only detect a 
media change by an actual directory READ operation. 

A similar situation occurs with directory hashing on removable 
drives. Because the directory hash table is a memory-resident 
table, the BDOS must verify all unsuccessful hash table searches on 
removable drives by accessing the directory. 

The net result of these actions is that there is a significant 
performance penalty associated with removable drives as compared to 
permanent drives. In addition, the protection provided by 
classifying a drive as removable is not total. Media changes are 
only detected during directory operations. If the media is changed 
on a drive during BDOS WRITE operations, the new disk can be 
damaged. 

The BIOS media flag facility gives you another option for 
supporting drives with removable media. However, to use this 
optioi), the disk controller must be capable of generating an 
interrupt when the drive door is opened. If your hardware provides 
this support, you can improve the handling of removable media by 
implementing the following procedure: 

1) Mark the drive as a permanent drive and set the DPB CKS 
parameter to the total number of directory entries, divided 
by four. For example, set the CKS field for a disk with 96 
directory entries to 8018H. 
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2) Implement an interrupt service routine that sets the @MEDIA 
flag in the System Control Block and the DPH MEDIA byte for 
the drive that signaled the door open condition. 

By using the media flag facility, you gain the performance 
advantage associated with permanent drives on drives that support 
removable media. The BDOS checks the System Control Block @MEDIA 
flag on entry for all disk-related function calls. If the flag has 
not been set, it implies that no disks on the system have been 
changed. If the flag is set, the BDOS checks the DPH MEDIA flag of 
each currently logged-in disk. If the DPH MEDIA flag of a drive is 
set, the BDOS reads the entire directory on the drive to determine 
whether the drive has had a media change before performing any other 
operations on the drive. In addition, it temporarily classifies any 
permanent disk with the DPH MEDIA flag set as a removable drive. 
Thus, the BDOS discards all directory physical record buffers when a 
drive door is opened to force all directory READ operations to 
access the disk. 

To summarize, using the BIOS MEDIA flag with removable drives 
offers two important benefits. First, because a removable drive can 
be classified as permanent, performance is enhanced. Second, 
because the BDOS immediately checks the entire directory before 
performing any disk-related function on the drive if the drive's DPH 
MEDIA flag is set, disk integrity is enhanced. 

End of Appendix A 
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Auto-Density Support 



Auto-density support refers to the capability of CP/M 3 to 
support different types of media on a single drive. For example, 
some floppy-disk drives accept single-sided and double-sided disks 
in both single-density and double-density formats. Auto-density 
support requires that the BIOS be able to determine the current 
density when SELDSK is called and to subsequently be able to detect 
a change in disk format when the READ or WRITE routines are called. 

To support multiple disk formats, the drive's BIOS driver must 
include a Disk Parameter Block (DPB) for each type of disk or 
include code to generate the proper DPB parameters dynamically. In 
addition, the BIOS driver must determine the proper format of the 
disk when the SELDSK entry point is called with register E bit 
equal to (initial SELDSK calls). If the BIOS driver cannot 
determine the format, it can return 0000H in register pair HL to 
indicate the select was not successful. Otherwise, it must update 
the Disk Parameter Header (DPH) to address a DPB that describes the 
current media, and return the address of the DPH to the BDOS. 

Note: All subsequent SELDSK calls with register E bit equal to 1, 
the BIOS driver must continue to return the address of the DPH 
returned in the initial SELDSK call. The value 0000H is only a 
legal return value for initial SELDSK calls. 

After a driver's SELDSK routine has determined the format of a 
disk, the driver's READ and WRITE routines assume this is the 
correct format until an error is detected. If an error is detected 
and the driver determines that the media has been changed to another 
format, it must return the value OFFH in register A. This signals 
the BDOS that the media has changed and the next BIOS call to the 
drive will be an initial SELDSK call. Do not modify the drive's DPH 
or DPB until the initial SELDSK call is made. Note that the BDOS 
can detect a change in media and will make an initial SELDSK call, 
even though the BIOS READ and WRITE routines have not detected a 
disk format change. However, the SELDSK routine must always 
determine the format on initial calls. 

A drive's Disk Parameter Header (DPH) has associated with it 
several uninitialized data areas: the allocation vector, the 
checksum vector, the directory hash table, and physical record 
buffers. The size of these areas is determined by DPB parameters. 
If space for these areas is explicitly allocated in the BIOS, the 
DPB that requires the most space determines the amount of memory to 
allocate. If the BIOS defers the allocation of these areas to 
GENCPM, the DPH must be initialized to the DPB with the largest 
space requirements. If one DPB is not largest in all of the above 
categories, a false one must be constructed so that GENCPM allocates 
sufficient space for each data area. 

End of Appendix B 
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Appendix C 
Modifying a CP/M 2 BIOS 



If you are modifying an existing CP/M 2.2 BIOS, you must note 
the following changes. 

• The BIOS jump vector is expanded from 17 entry points in CP/M 
2.2 to 33 entry points in CP/M 3. You must implement the 
necessary additional routines. 

• The Disk Parameter Header and Disk Parameter Block data 
structures are expanded. 

See Section 3 of this manual, "CP/M 3 BIOS Functional 
Specifications", for details of the BIOS data structures and 
subroutines. The following table shows all CP/M 3 BIOS functions 
with the changes necessary to support CP/M 3. 





Table ( 


C-l. CP/M 3 BIOS Functions 




Function 


Meaning 








BIOS 


Function 


00 : BOOT 

The address for the 
be obtained from 
Control Block. 


JMP at location 
@MXTPA in the 


5 must 
System 


BIOS 


Function 


01: WBOOT 

The address for the JMP at location 
be obtained from @MXTPA in the 
Control Block. The CCP can be re 
from a file. 


5 must 
System 
loaded 


BIOS 


Function 


02: 
Can 


CONST 

be implemented 


unchanged. 






BIOS 


Function 


03: CONIN 

Can be implemented unchanged, 
the high-order bit. 


Do not mask 
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Table C-l. (continued) 



Function 


Meaning 


BIOS 


Function 


04: CONOUT 
Can be implemented unchanged. 


BIOS 


Function 


05: LIST 
Can be implemented unchanged. 


BIOS 


Function 


06: AUXOUT 

Called PUNCH in CP/M 2. Can be 
implemented unchanged. 


BIOS 


Function 


07: AUXIN 

Called READER in CP/M 2. Can be 
implemented unchanged. Do not mask the 
high-order bit. 


BIOS 


Function 


08: HOME 
No change . 


BIOS 


Function 


09: SELDSK 

Can not return a select error when SELDSK 
is called with bit in register E equal 
to 1. 


BIOS 


Function 


10: SETTRK 
No change. 


BIOS 


Function 


11: SETSEC 

Sectors are physical sectors, not logical 
128-byte sectors. 


BIOS 


Function 


12: SETDMA 

Now called for every READ or WRITE 
operation. The DMA buffer can now be 
greater than 128 bytes. 
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Table C-l. (continued) 



Function 


Meaning 


BIOS 


Function 


13 : READ 

READ operations are in terms of physical 
sectors. READ can return a OFFH error 
code if it detects that the disk format 
has changed. 


BIOS 


Function 


14: WRITE 

WRITE operations are in terms of physical 
sectors. If write detects that the disk 
is Read-Only, it can return error code 2. 
WRITE can return a OFFH error code if it 
detects that the disk format has changed. 


BIOS 


Function 


15: LISTST 
Can be implemented unchanged. 


BIOS 


Function 


16: SECTRN 

Sectors are physical sectors, not logical 
128-byte sectors. 



The following is 
BIOS Function 17 
BIOS Function 18 
BIOS Function 19 
BIOS Function 20 
BIOS Function 21 
BIOS Function 22 
BIOS Function 23 
BIOS Function 24 
BIOS Function 25 
BIOS Function 26 



a list of new BIOS functions: 
CONOST 
AUXIST 
AUXOST 
DEVTBL 
DEVINI 
DRVTBL 
MULTIO 
FLUSH 
MOVE 
TIME 
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BIOS Function 27: SELMEM 

BIOS Function 28: SETBNK 

BIOS Function 29: XMOVE 

BIOS Function 30: USERF 

BIOS Function 31: RESERV1 

BIOS Function 32: RESERV2 

End of Appendix C 
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CPM3.SYS File Format 



Table D-l. CPM3.SYS File Format 



Record 



Contents 



Header Record (128 bytes) 

1 Print Record (128 bytes) 
2-n CP/M 3 operating system in 

reverse order, top down. 



Table D-2. Header Record Definition 



Byte 


Contents 





Top page plus one, at which the resident 
portion of CP/M 3 is to be loaded top 
down . , 


1 


Length in pages (256 bytes) of the 
resident portion of CP/M 3. 


2 


Top page plus one, at which the banked 
portion of CP/M 3 is to be loaded top 
down. 


3 


Length in pages (256 bytes) of the banked 
portion of CP/M 3. 


4-5 


Address of CP/M 3 Cold Boot entry point. 


6-1 


Reserved. 


16-51 


Copyright Message. 


52 


Reserved. 


53-58 


Serial Number. 


59-127 


Reserved. 



The Print Record is the CP/M 3 Load Table in ASCII, 
terminated by a dollar sign ($). 

End of Appendix D 
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Appendix E 
Root Module of the Relocatable BIOS for CP/M 3 



All the listings in Appendixes E through I are assembled with 
RMAC, the CP/M Relocating Macro Assembler, and cross-referenced with 
XREF, an assembly language cross-reference program used with RMAC. 
These listings are output from the XREF program. The assembly 
language sources are on your distribution disk as .ASM files. 

1 title 'Root module of relocatable BIOS for CP/M 3.0' 

2 

3 ; version 1.0 15 Sept 82 



5 


FFFF - 


6 


0000 - 


7 




8 


FFFF - 


9 




10 




11 




12 




13 




14 




15 




16 




17 




18 




19 




20 




21 




22 




23 




24 




25 


000D - 


26 


000A - 


27 


0007 - 


28 


0011 = 


29 


0013 » 


30 




31 


0100 = 


32 




33 




34 




35 




36 




37 




38 




39 




40 




41 




42 




43 




44 




45 




46 




47 




48 




49 




50 




51 




52 




53 




54 




55 




56 




57 




58 




59 





true 
false 



equ -1 

equ not true 



banked equ true 



Copyright (C) , 1982 
Digital Research, Inc 
P.O. Box 579 
Pacific Grove, CA 93950 



This is the invariant portion of the modular BIOS and is 
distributed as source for informational purposes only. 
All desired modifications should be performed by 
adding or changing externally defined modules. 
This allows producing "standard" I/O modules that 
can be combined to support a particular system 
configuration. 



cr 


equ 13 


If 


equ 10 


bell 


equ 7 


ctlQ 


equ 'Q'-' 


ctlS 


equ 'S'-' 


ccp 


equ OlOOh 




cseg 



; Console Command Processor gets loaded into the TPA 
; GENCPM puts CSEG stuff in common memory 



; variables in system data page 

extrn gcovec,9civec,<!aovec,f>aivec,eiovec ; I/O redirection vectors 
extrn Smxtpa ; addr of system entry point 

extrn gbnkbf ; 128 byte scratch buffer 



; initialization 

extrn ?init 

extrn ?ldccp,?rlccp 

; user defined character I/O routines 

extrn 7ci ,?co,?cist ,?cost 
extrn ?cinit 
extrn Sctbl 

! disk communication data items 

extrn gdtbl 

public @adrv,@rdrv,atrk,@sect 

public 9dma,edbnk,9cnt 

; memory control 



; general initialization and signon 
; load & reload CCP for BOOT & WBOOT 



each take device in <B> 
(re) initialize device in <C> 
physical character device table 



table of pointers to XDPHs 
parameters for disk I/O 



Listing E-l. Root Module of Relocatable BIOS for CP/M 3 
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79 

80 

81 

82 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 

100 

101 

102 

103 

104 

105 

106 

107 

108 

109 

110 

111 

112 

113 

114 

115 

116 

117 

118 

119 

120 

121 

122 

123 

124 

125 

126 

127 

128 

129 

130 

131 

132 

133 

134 

135 

136 

137 

138 

139 

140 

141 

142 

143 



0000 C30000 
0003 C36C00 

0006 C37701 
0009 C39201 
000C C3DA00 
000F C3E600 
0012 C3E000 
0015 C39801 



0018 
001B 
001G 
0021 
0024 
0027 
002A 

002D 
0030 

0033 
0036 
0039 
003C 
003F 



C36E00 
C33F00 
C37100 
C37700 
C37D00 
C39400 
C3AA00 

C31201 
C38900 

C30601 
C37D01 
C30C01 
C3D200 
C30000 



0042 C3D600 
0045 C3CB00 
0048 C3CF00 

004B C30000 
004E C30000 
0051 C32502 
0054 C38500 
0057 C30000 

005A C30000 
005D C30000 
0060 C30000 



public gcbnk 
extcn ?xmove,?move 
extrn 7bank 

( clock support 

extrn 7time 

; general utility routines 

public ?pmsg,7pdec 
public 7pderr 

maclib mode baud 



; current bank 

• select move bank, and block move 

; select CPU bank 



; signal time operation 



; print message, print number from to 65535 
t print BIOS disk error message header 



; define mode bits 



j External names for BIOS entry points 

public 7boot,?wboot,7const,7conin,7cono,71ist,?auxo,7auxi 
public ?home,?sldsk,?sttrk,7stsec,?stdma,7read,7write 
public ?lists,7sctrn 

public 7conos,?auxis,7auxos,?dvtbl,?devin,7drtbl 
public ?mltlo,?flush,?mov,?tim,?bnksl,?stbnk,?xmov 



t BIOS Jump vector. 

t All BIOS routines are invoked by calling these 
; entry points. 



7boot: 
7wboot: 

7const: 

7conin: 

7conoi 

71ist: 

7auxo; 

7auxi: 

7 home: 

7sldsk: 

7sttrk: 

7stsec: 

?stdma: 

?read: 

7write: 

?lists: 
?sctrn: 

7conos: 
?auxis: 
7auxos: 
?d"tbl! 
7devin: 

7drtbl: 
7mltio: 
?flushs 

7mov: 

7tim: 

?bnksl: 

7stbnk: 

?xmov: 



mp boot ; initial entry on cold staxt 

mp wboot ; reentry on program exit, warm start 

mp const ; return console input status 

mp conin ; return console input character 

mp conout ; send console output character 

mp list ( send list output character 

mp auxout i send auxilliary output character 

mp auxin j return auxilliary input character 

imp home ; set disks to logical home 

Imp seldsk ; select disk drive, return disk parameter info 

imp settrk ; set disk track 

jmp setsec ; set disk sector 

Imp setdma j set disk I/O memory address 

imp read ; read physical block (s) 

imp write ; write physical block (s) 

imp listst ; return list device status 

imp sectrn ; translate logical to physical sector 

mp conost ; return console output status 

mp auxist > return aux input status 

mp auxost t return aux output status 

mp devtbl ; return address of device def table 

mp 7cinit j change baud rate of device 

mp getdrv ; return address of disk drive table 

mp multio t set multiple record count for disk I/O 

mp flush ; flush BIOS maintained disk caching 

|mp 7move ; block move memory to memory 

imp 7time ; Signal Time and Date operation 

Imp bnksel ; select bank for code execution and default DMA 

imp setbnk ; select different bank for disk I/O DMA operations. 

Imp 7xmove ; set source and destination banks for one operation 

imp ; reserved for future expansion 

imp s reserved for future expansion 

|mp } reserved for future expansion 



dseg 



Initial entry point for system startup. 
; this part can be banked 



boot: 
0000 31D200 lxi sp,boot$stack 

0003 0E0F mvi c,15 j initialize all 16 character devices 

c$init$loop: 
0005 C5CDO00OC1 push b I call 7cinit I pop b 
000A 0DF20500 dcr c I jp c$inlt$loop 



Listing E-l. (continued) 
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144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 



O00E CD0000 



call ?init 



perform any additional system initialization 
and print signon message 



0011 0100102100 lxi b, 16*256+0 I lxi h,§dtbl 
d$init$loop: 

0017 C5 

0018 5E235623 
001C 7BB2CA3600 
0021 E5 push 

xchg 

dcx h 1 dcx 



init all 16 logical disk drives 



push b ; save remaining count 

mov e,m I inx h I mov d,m 1 inx h 
mov a,e ! ora d I jz d$init$next 



0022 EB 

0023 2B2B7E32EE 
0029 7932ED00 
002D 2B 
002E 562B5E 
0031 EBCDB601 

0035 El 

0036 CI 

0037 0C05C21700 
003C C36300 



! mov a,m ! sta 9RDRV 



mov a,c 1 sta @ADRV 
dcx h 

mov d,m 1 dcx h ! mov e,m 
xchg 1 call ipchl 
pop h 
d$init$next: 
pop b 

inr c ! dcr 
jmp boot$ 1 



jnz d$init$loop 



cseg 



following in resident memory 



0063 CD7800 
0066 CD0000 
0069 C30001 



006C 31D200 
006F CD7800 
0072 CD0000 
0075 C30001 



call setSjumps 
call ?ldccp 
jmp ccp 



and abs drive 

grab @drv entry 
if null, no drive 
save ?drv pointer 
XDPH address in <HL> 
get relative drive code 
get absolute drive code 
point to init pointer 
get init pointer 
call init routine 
recover @drv pointer 

recover counter and drive I 
and loop for each drive 



fetch CCP for firsit time 



Entry for system restarts. 



lxi sp,boot$stack 
call set$jumps 
call ?rlccp 
jmp ccp 



initialize page zero 

reload CCP 

then reset jmp vectors and exit to ccp 



set$jumps: 

if banked 
0078 3E01CD5100 mvi a,l I call 7bnksl 
endif 



007D 3EC3 
007F 3200003205 
0085 2103002201 
008B 2A00002206 
0091 C9 



mvi a, JMP 

sta I sta 5 

lxi h,?wboot 1 shld 1 

lhld SMXTPA ! shld 6 

ret 



set up jumps in page zero 
BIOS warm start entry 
BDOS system call entry 



0092 ds 64 

00D2 = bootSstack equ $ 



Return address of character device table 



devtbl: 
00D2 210000C9 lxi h,@ctbl ! ret 



Return address of drive table 



getdrv: 
00D6 210000C9 lxi h,@dtbl 1 ret 



Console Output. Send character in <C> 
to all' selected devices 



00DA 2A0000 
00DD C3E900 



lhld @covec 
jmp out$scan 



fetch console output bit vector 



Listing E-l. (continued) 
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225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 
269 
270 
271 
272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 
289 
290 
291 
292 
293 
294 
295 
296 
297 
298 
299 
300 
301 
302 
303 
304 
305 
306 
307 



Auxiliary Output. Send character in <C> 
to all selected devices 



auxout: 
00E0 2A0000 lhld @aovec 

O0E3 C3E900 jmp out$scan 



; fetch aux output bit vector 



List Output. Send character in <C> 

to all selected devices. 



00E6 2A0000 



lhld glovec 



; fetch list output bit vector 



00E9 060F 

00EB 29 
00EC D2FF00 
00EF E5 
00F0 C5 

00F1 CD2C01B7CA 
00F8 C1C5 
00FA CD0000 
00FD CI 
00FE El 

00FF 05 
0100 7CB5 
0102 C2EB00 
0105 C9 



0106 2A0000 
0109 C31501 



010C 2A0000 
010F C31501 



0112 2A000O 



0117 
0118 
0119 
011A 
011C 
011F 
0120 
0121 
0122 
0123 
0124 
0126 
0129 
012B 



C5 

3EFF 

DC2C01 



B7 

C8 

05 

7CB5 

C21701 

F6FF 

C9 



out$scan: 

mvi b,15 ; start with device 15 
co$next: 

dad h ; shift out next bit 

jnc not$out$device 

push h j save the vector 

push b ; save the count and character 

not$out$ready: 

call coster 1 ora a I jz not$out$ready 

pop b I push b i restore and resave the character and device 

call ?co ; if device selected, print it 

pop b ; recover count and character 

pop h ; recover the rest of the vector 

not$out$device: 

dcr b ; next device number 

mov a,h 1 ora 1 ; see if any devices left 

jnz co$next ; and go find them... 

ret 



Console Output Status. Return true if 

all selected console output devices 
are ready. 



lhld flcovec ; get console output bit vector 
jmp ostSscan 



Auxiliary Output Status. Return true if 

all selected auxiliary output devices 
are ready. 



lhld ?aovec j get aux output bit vector 
jmp ost$scan 



List Output Status. Return true if 

all selected list output devices 
are ready. 



lhld §lovec 

os t$ scan: 

mvi b,15 
cosSnext: 

dad h 

push h 

push b 

mvi a,0FFh 

cc coster 

pop b 

pop h 

ora a 

rz 

dcr b 

mov a,h I ora 1 

jnz cos$next 

ori OFFh 

ret 



get list output bit vector 



start with device 15 

check next bit 

save the vector 

save the count 

assume device ready 

check status for this device 

recover count 

recover bit vector 

see if device ready 

if any not ready, return false 

drop device number 

see if any more selected devices 

all selected were ready, return true 
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308 
309 
310 
311 
3L2 
313 
314 
315 
316 
317 
318 
319 
320 
321 
322 
323 
324 
325 
326 
327 
328 
329 
330 
331 
332 
333 
334 
335 
336 
337 
338 
339 
340 
341 
342 
343 
344 
345 
346 
347 
348 
349 
350 
351 
352 
353 
354 
355 
356 
357 
358 
359 
360 
361 
362 
363 
364 
365 
366 
367 
368 
369 
370 
371 
372 
373 
374 
375 
376 
377 
378 
379 
380 
381 
382 
383 
384 
385 
386 
387 
388 
389 
390 



01 2C 
012F 
0130 
0133 
0137 
013A 
013B 
013E 
0142 
0145 
0149 
014E 

0150 
0155 

0157 
0158 
015B 
015C 



682600 

E5 

292929 

11060019 

7EE610 

El 

CA0000 

112B0219 

CD5D01 

7EC46F01 

FE11C25001 

3EFF 

FE13C25701 
3E00 



CD6601 

A6 

C9 



check for output device ready, including optional 
xon/xoff support 



not$q: 



015D C5E5 
015F CD0O0O 
0162 E1C1 

0164 B7 

0165 C9 



0166 C5E5 
0168 CD0000 
016B E1C1 
016D B7 
016E C9 



016F C5E5 
0171 CD000O 
0174 E1C1 
0176 C9 



0177 2A000O 
017A C38001 



017D 2AOO0O 



0180 060F 

0182 29 

0183 3E00 
0185 DC5D01 
0188 B7C0 
018A 05 
018B 7CB5 
018D C28201 

0190 AF 

0191 C9 



0192 2AOO0O 
0195 C39B01 



mov l,b I mvi h,0 

push h 

dad h 1 dad h 1 dad h 

lxi d,@ctbl+6 I dad d 

mov a, in I ani mb$xonxoff 

pop h 

jz ?cost 

lxi d.xofflist I dad d 

call cistl 

mov a,m I cnz cil 

cpi ctlq 1 jnz not$q 

mvi a.OFFh 

cpi ctls 1 jnz not$s 
mvi a,00h 

mov m,a 
call costl 
ana m 
ret 



make device code 16 bits 

save it in stack 

create offset into device characteristics tbl 

make address of mode byte 

; recover console number in <HL> 

; not a xon device, go get output status direct 

; make pointer to proper xon/xoff flag 

; see if this keyboard has character 

; get flag or read key if any 

; if its a ctl-Q, 

; set the flag ready 

I if its a ctl-S, • 
i clear the flag 

> save the flag 

; get the actual output status, 

; and mask with ctl-Q/ctl-S flag 

; return this as the status 



push b I push 
call 7clst 
pop h I pop b 
ora a 
ret 



push b I push h 
call ?cost 
pop h I pop b 
ora a 
ret 



; get input status with <BC> and <HL> saved 



get output status, saving <BC> & <HL> 



push b i push h 
call ?ci\ 
pop h I pop b 
ret \ 



} get input, saving <BC> & <HL> 



Console Input Status. Return true if 

any selected console input device 
has an available character. 



lhld ?civec 
jmp ist$scan 



get console input bit vector 



Auxiliary Input Status. Return true if 

any selected auxiliary input device 
has an available character. 



lhld ?aivec 

1st? scan: 

mvi b,15 

cis$next: 

dad h 
mvi a,0 
cc cistl 
ora a I rnz 
dcr b 



; get aux input bit vector 
; start with device 15 



; check next bit 

; assume device not ready 

; check status for this device 

; if any ready, return true 

; drop device number 

mov a,h I ora 1 j see if any more selected devices 
jnz cis$next 

xra a ; all selected were not ready, return false 

ret 



Console Input. Return character from first 
ready console input device. 



lhld 8civec 
jmp in$scan 
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391 
392 
393 
394 
395 
396 
397 
398 
399 
400 
401 
402 
403 
404 
405 
406 
407 
40S 
409 
410 
411 
412 
413 
414 
415 
416 
417 
418 
419 
420 
421 
422 
423 
424 
425 
426 
427 
428 
429 
430 
431 
432 
433 
434 
435 
436 
437 
438 
439 
440 
441 
442 
443 
444 
445 
446 
447 
448 
449 
450 
451 
452 
453 
454 
455 
456 
457 
458 
459 
460 
461 
462 
463 
464 
465 
466 
467 
468 
469 
470 
471 
472 
473 
474 



Auxiliary Input. Return character from first 
ready auxiliary input device. 



0198 2A0000 



019B E5 
019C 060F 



019E 
019F 
01A1 
01A4 
01A5 
01A8 
01A9 
01AB 
01AE 
01AF 



29 

3E00 

DC5D01 

B7 

C2B201 

05 

7C35 

C29E01 



lhld Saivec 



push h 
mvi b,15 

dad h 

mvi a,0 

cc cistl 

ora a 

jnz ci$rdy 

dcr b 

mov a,h I ora 1 

jnz ciSnext 

pop h 

jmp inSscan 



save bit vector 



; shift out next bit 

; insure zero a (nonexistant device not ready) . 

; see if the device has a character 

; this device has a character 

; else, next device 

; see if any more devices 

; go look at them 

; recover bit vector 

; loop til we find a character 



01B2 El 
01B3 C30000 



ci$rdy: 



pop h 
jmp ?ci 



; discard extra stack 



Utility Subroutines 



ipchl: 



pchl 



vectored CALL point 



?pmsg: ; print message ?<HL> up to a null 

; saves <BC> & <DE> 
01B7 C5 push b 

01B8 D5 push d 

pmsgSloop: 
01B9 7EB7CAC801 mov a, in I ora a ! jz pmsg$exit 
01BE 4FE5 mov c,a 1 push h 

01C0 CD0C00E1 call ?cono ! pop h 

01C4 23C3B901 inx h ! jmp pmsgSloop 

pmsg$exit: 
01C8 Dl pop d 

01C9 CI pop b 

01CA C9 ret 

Ppdec: ; print binary number 0-65535 from <HL> 

01CB 01F30111F0 lxi b.tablelO! Ixi d, -10000 

next: 

01D1 3E2F mvi a, 'O'-l 

pdecl: 

01D3 E53C19D2DE push hi inr al dad dl jnc stoploop 

01D9 3333C3D301 inx spl inx spl jmp pdecl 

stoploop: 

01DE D5C5 push dl push b 

01EO 4FCD0C00 mov c,a! call ?cono 

01E4 C1D1 pop bl pop d 

nextdigit: 

01E6 El pop h 

01E7 0A5F03 ldax bl mov e,al inx b 

01EA 0A5703 ldax bl mov d,al inx b 

01ED 7BB2C2D101 mov a, el ora dl jnz next 

01F2 C9 ret 



tablelO: 



01F3 18FC9CFFF6 



-1000,-100,-10,-1,0 



01FD 21D100CDB7 
0203 3AED00C641 
020C 21E300CDB7 
0212 2AEF00CDCB 
0218 21E800CDB7 
021E 2AF100CDCB 
0224 C9 



Vpderr : 



lxi h,drive$msg 1 call ?pmsg 

Ida §adrv 1 adi 'A' 1 mov c,a 

lxi h,track$msg 1 call ?pmsg 

lhld etrk I call ?pdec 

lxi h,sector$msg 1 call ?pmsg 

lhld §sect ! call 7pdec 

ret 



1 call ?cono 



error header 
drive code 
track header 
track number 
sector header 
sector number 



Bank Select. Select CPU bank for further execution. 
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475 
476 
477 
478 
479 
480 
481 
482 
483 
484 
4 85 
486 
4 87 
488 
489 
490 
491 
492 
493 
494 
495 
496 
4 97 
498 
499 
500 
501 
502 
503 
504 
505 
506 
507 
508 
509 
510 
511 
512 
513 
514 
515 
516 
517 
518 
519 
520 
521 
522 
523 
524 
525 
526 
527 
528 
529 
530 
531 
532 
533 
534 
535 
536 
537 
538 
539 
540 
541 
542 
543 
544 
545 
546 
547 
548 
549 
550 
551 
552 
553 
554 
555 



0225 323B02 
0228 C30000 



sta @cbnk 
jmp ?bank 



; remember current bank 

l and go exit through users 

t physical bank select routine 



022B FFFFFFFFFFxoffllst 
0233 FFFFFFFFFF 



db 
db 



-1,-1,-1,-1,-1,-1,-1,-1 
-1,-1,-1,-1,-1,-1,-1,-1 



; ctl-s clears to zero 



dseg 



! following resides in banked memory 



Disk I/O interface routines 



Select Disk Drive. Drive code - in <C> . 

Invoke login procedure for drive 
if this is first select. Return 
address of disk parameter header 
in <HL> 



seldsk: 



003F 7932ED00 
0043 69260029 
0047 01000009 
004B 7E23666F 
004F B4C8 
0051 7BE601C26D 
0057 E5EB 
0059 21FEFF197E 
0061 21FAFF19 
0065 7E23666F 
0069 CDB601 
006C El 

006D C9 



006E 010000 



0071 6960 
0073 22EF00 
0076 C9 



0077 6960 
0079 22F100 
007C C9 



mov a,c I sta Sadrv 
mov l,c 1 mvi h,0 I dad h 
lxi b,@dtbl 1 dad b 
mov a,m I inx h I mov h,m I mov l,a 
ora h I rz 

mov a,e I ani 1 I jnz not$f irstSselect 
push h 1 xchg 

lxi h,-2 1 dad d 1 mov a,m ! sta @RDRV 
lxi h,-6 1 dad d 

mov a,m 1 inx h I mov h,m 1 mov l,a 
call ipchl 
pop h 
not$ first$ select: 
ret 



save drive select code 

create index from drive code 

get pointer to dispatch table 

point at disk descriptor 

if no entry in table, no disk 

examine login bit 

put pointer in stack & <DE> 

get relative drive 

find LOGIN addr 

get address of LOGIN routine 

call LOGIN 

recover DPH pointer 



007D 6960 
007F 22F300 



0082 3A3B02 



Home selected drive. Treated as SETTRK(O), 



lxi b,0 ; same as set track zero 



Set Track. Saves track address from <BC> 
in @TRK for further operations. 



mov l,c 1 mov h,b 

shld etrk 

ret 



Set Sector. Saves sector number from <BC> 
in gsect for further operations. 



mov l,c 1 mov h,b 

shld gsect 

ret 



Set Disk Memory Address. Saves DMA address 

from <BC> in @DMA and sets gDBNK to 8CBNK 
so that further disk operations take place 
in current bank. 



mov l,c I mov h,b 
shld @dma 



default DMA bank is current bank 
fall through to set DMA bank 
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556 
557 
558 
559 
560 
561 
562 
563 
564 
565 
566 
567 
568 
569 
570 
571 
572 
573 
574 
575 
576 
577 
578 
579 
580 
581 
582 
583 
584 
585 
586 
587 
588 
589 
590 
591 
592 
593 
594 
595 
596 
597 
598 
599 
600 
601 
602 
603 
604 
605 
606 
607 
608 
609 
610 
611 
612 
613 
614 
615 
616 
617 
618 
619 
620 
621 
622 
623 
624 
625 
626 
627 
628 
629 
630 
631 
632 
633 
634 
635 
636 
637 



Set Disk Memory Bank. Saves bank number 
in @DBNK for future disk data 
transfers. 



0085 32F600 
0088 C9 



sta gdbnk 
ret 



; SECTRN 



0089 6960 
008B 7AB3C8 
008E EB096E2600 
0093 C9 



0094 2AED002600 
009A 11000019 
009E 7E23666F 
00A2 E5 
00A3 11F8FF19 
00A7 C3BD00 



00AA 2AED002600 
00B0 11000019 
00B4 7E23666F 
00B8 E5 
00B9 11F6FF19 



Sector Translate. Indexes skew table in <DE> 

with sector in <BC> . Returns physical sector 
in <HL>. If no skew table (<DE>=0) then 
returns physical" logical. 



mov l,c I mov h,b 

raov a,d I ora e 1 rz 

xchg 1 dad b I mov l,m 1 mvi h,0 

ret 



Read physical record from currently selected drive. 
Finds address of proper read routine from 
extended disk parameter header (XDPH) . 



lhld Sadrv I mvi h,0 ! dad h 

lxi d,?dtbl I dad d 

mov a, i 

push h 

lxi d,-8 I dad 

jmp rw$common 



get drive code and double it 
make address of table entry 
I inx h I mov h,m 1 mov l,a ; fetch table entry 
; save address of table 

point to read routine address 
use common code 



; Write physical sector from currently selected drive. 

; Finds address of proper write routine from 

; extended disk parameter header (XDPH) . 

lhld gadrv i mvi h,0 I dad h ; get drive code and double it 

lxi d,gdtbl I dad d j make address of table entry 

mov a,m 1 inx h I mov h,m 1 mov l,a ; fetch table entry 

push h ; save address of table 

lxi d,-10 I dad d ; point to write routine address 



00BD 7E23666F 
00C1 Dl 
00C2 1B1B 
00C4 1A32EE00 
00C8 1313 
O0CA E9 



00CB 32F500C9 



rw$ common: 



mov a,m 1 inx h 1 mov h,m I mov l,a 



pop d 

dcx d 1 dcx d 

ldax d 1 sta Srdrv 

inx d 1 inx d 

pchl 



get address of routine 



recover address of table 

point to relative drive 

get relative drive code and post it 

point to DPH again 

leap to driver 



Set multiple sector count. Saves passed count in 
8CNT 



sta Sent 1 ret 



BIOS deblocking buffer flush. Not implemented. 



xra a 1 ret 



return with no error 



; error message components 
00D1 0D0A074249drive$msg db cr , If , bell, 'BIOS Error on ',0 
00E3 3A20542D00track$msg db ': T-',0 
00E8 2C20532D00sector$msg db ', S-',0 



; disk communication data items 
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638 










639 


00ED 




@adrv 


ds 1 


640 


00EE 




@rdrv 


ds 1 


641 


00EF 




@trk 


ds 2 


642 


00F1 




gsect 


ds 2 


643 


00F3 




@dma 


ds 2 


644 


00F5 


00 


gent 


db 


645 


00F6 


00 


gdbnk 


db 


646 










647 










648 








cseg ; 


649 










650 


023B 


00 


@cbnk 


db 


651 










652 










653 


023C 






end 


AUXIN 




0198 


99 


397# 


AUXIST 




017D 


113 


367t 


AUXOST 




010C 


114 


2771 


AUXOUT 




00E0 


98 


2301 


BANKED 




FFFF 


81 


186 


BAUD110 




0003 






BAUD1200 




0008 






BAUD134 




0004 






BAUD 150 




0005 






BAUD1800 




0009 






BAUD1920C 


I 


000F 






BAUD2400 




000A 






BAUD300 




0006 






BAUD3600 




OOOB 






BAUD4800 




OOOC 






BAUD50 




0001 






BAUD600 




0007 






BAUD7200 




000D 






BAUD75 




0002 






BAUD9600 




000E 






BAUDNONE 




0000 






BELL 




0007 


27# 


632 


BNKSEL 




0225 


124 


4751 


BOOT 




0000 


91 


1381 


B0OT1 




0063 


164 


1681 


BOOTSTACK 




0OD2 


139 


178 1981 


CCP 




0100 


311 


171 181 


CI1 




016F 


319 


3451 


CINEXT 




019E 


4031 


411 


CINITLOOF 




0005 


1411 


143 


CIRDY 




01B2 


408 


4151 


CISNEXT 




0182 


3721 


379 


CIST1 




015D 


318 


3311 375 


CONEXT 




OOEB 


2441 


258 


CON IN 




0192 


95 


3881 


CONOST 




0106 


112 


2671 


CONOUT 




OODA 


96 


2201 


CONST 




0177 


94 


3571 


COSNEXT 




0117 


2921 


304 


COST1 




0166 


327 


3381 


COSTER 




012C 


250 


297 3081 


CR 




000D 


251 


632 


CTLQ 




0011 


281 


320 


CTLS 




0013 


291 


323 


DEVTBL 




00D2 


115 


2041 


DINITLOOE 




0017 


1491 


163 


DINITNEXT 




0036 


152 


1611 


DRIVEMSG 




00D1 


463 


6321 


FALSE 




0000 


61 




FLUSH 




OOCF 


120 


6261 


GETDRV 




00D6 


118 


2111 


HOME 




006E 


101 


5201 


INSCAN 




019B 


390 


4001 413 


IPCHL 




01B6 


159 


4231 511 


ISTSCAN 




0180 


359 


3701 


LF 




000A 


261 


632 


LIST 




00E6 


97 


2391 


LISTST 




0112 


109 


287# 


MBINOUT 




0003 






MBINPUT 




0001 






MBOUTPUT 




0002 






MBSERIAL 




0008 






MBSOFTBAUD 


0004 






MBXONXOFF 




0010 


314 




MULTIO 




OOCB 


119 


6191 



; currently selected disk drive 

; controller relative disk drive 

; current track number 

; current sector number 

; current DMA address 

; record count for multisector transfer 

; bank for DMA operations 



common memory 



; bank for processor operations 
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NEXT 


01D1 


4431 


456 






NEXTDIGIT 


01E6 


4521 








NOTFIRSTSEiECT 


006D 


506 


5131 






NOTOUTDEVICE 


OOFF 


246 


255f 






NOTOUTREADY 


O0F1 


2491 


250 






NOTQ 


0150 


320 


3221 






NOTS 


0157 


323 


325# 






OSTSCAN 


0115 


269 


279 


290# 




OUTS CAN 


00E9 


223 


232 


2421 




PDECL 


01D3 


4451 


447 






PMSGEXIT 


01C8 


432 


4361 






PMSGLOOP 


01B9 


431f 


435 






READ 


0094 


106 


5851 






RWCOMMON 


00BD 


591 


6061 






SECTORMSG 


O0E8 


467 


6341 






SECTRN 


0089 


110 


5731 






SELDSK 


003F 


102 


5001 






SETBNK 


0085 


125 


5621 






SETDMA 


007D 


105 


5501 






SETJUMPS 


0078 


169 


179 


1841 




SETS EC 


0077 


104 


5381 






SETTRK 


0071 


103 


5281 






STOPLOOP 


01DE 


446 


4481 






TABLE10 


01F3 


442 


4591 






TRACKMSG 


00E3 


465 


633# 






TRUE 


FFFF 


5# 


6 


8 




WBOOT 


006C 


92 


1771 






WRITE 


00AA 


107 


599# 






XOFFLIST 


022B 


317 


4811 






7AUXI 


0015 


79 


991 






7AUXIS 


0036 


82 


1131 






7AUXO 


0012 


79 


981 






7AUXOS 


0039 


82 


114» 






7BANK 


0000 


63 


477 






7BNKSL 


0051 


83 


1241 


187 




7BOOT 


0000 


79 


91# 






?CI 


0000 


49 


347 


417 




7CINIT 


0000 


50 


116 


142 




7CIST 


0000 


49 


333 






7 CO 


0000 


49 


252 






7CONIN 


0009 


79 


951 






7CONO 


oooc 


79 


96# 


434 450 464 


7CONOS 


0033 


82 


1121 






7CONST 


0006 


79 


94» 






7COST 


0000 


49 


316 


340 




7DEVIN 


003F 


82 


116# 






7DRTBL 


0042 


82 


1181 






7DVTBL 


003C 


82 


1151 






7FLUSH 


0048 


83 


1201 






7 HOME 


0018 


80 


1011 






7INIT 


0000 


44 


145 






7LDCCP 


0000 


45 


170 






7LIST 


000F 


79 


97» 






7LISTS 


002D 


81 


1091 






7MLTIO 


0045 


83 


1191 






7 MOV 


004B 


83 


122t 






7MOVE 


0000 


62 


122 






7PDEC 


01CB 


71 


4411 


466 468 


7PDERR 


01FD 


72 


4621 






7PMSG 


01B7 


71 


4271 


463 465 467 


7 READ 


0027 


80 


106» 






7RLCCP 


0000 


45 


180 






7SCTRN 


0030 


81 


1101 






7SLDSK 


001B 


80 


1021 






7STBNK 


0054 


83 


1251 






7STDMA 


0024 


80 


105t 






7STSEC 


0021 


80 


1041 






7STTRK 


001E 


80 


1031 






7TIM 


004E 


83 


1231 






7TIME 


0000 


67 


123 






7 WBOOT 


0003 


79 


92J 


192 




7WRITE 


002A 


80 


107# 






7XMOV 


0057 


83 


1261 






7XMOVE 


0000 


62 


126 






@ADRV 


OOED 


56 


156 


464 501 586 


@AIVEC 


0000 


38 


368 


398 




9AOVEC 


0000 


38 


231 


278 




@BNKBF 


0000 


40 








@CBNK 


023B 


61 


476 


554 6501 


@CIVEC 


0000 


38 


358 


389 




@CNT 


OOFS 


57 


620 


6441 




eCOVEC 


0000 


38 


222 


268 
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JCTBL 


0000 


51 


205 


313 




SDBNK 


00F6 


57 


563 


6451 




SDMA 


00F3 


57 


552 


6431 




gDTBL 


0000 


55 


148 


212 


503 


8L0VEC 


0000 


38 


240 


288 




SMXTPA 


0000 


39 


193 






JRDRV 


00EE 


56 


155 


508 


610 


6SECT 


00F1 


56 


468 


540 


642t 


?TRK 


00EF 


56 


466 


530 


6411 



Listing E-l. (continued) 
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System Control Block Definition for CP/M 3 BIOS 



The SCB.ASM module contains the public definitions of the 
various fields in the System Control Block. The BIOS can reference 
the public variables. 



titlt 'System Control Block Definition for CP/M3 BIOS' 

public *.clvec. tcovec. taivec. Saovec. Clovtci tbnkbf 
public ffcrdma. (Jcrdsk. fivinfo. Sresel. 8fx. Sutrcd 
public emltio. eermde. Gerdsk, Cmfdia. ebflgs 
public ddatt. *hour, Cmin, 8stc» ?trjmp. Cmitpa 



FE3E - 
FE3F - 

FE41 - 
FE43 « 

FE44 » 
FE4A - 

FE4B » 
FE5I = 
FE54 « 



FE5A 
FE5B 
FE5C 
FE5F 



icbtbast equ 


OFEOOH 


•CIVEC 


equ 


scb»oase+22h 


ftCOVEC 


equ 


scb»base+24h 


9AIVEC 


l(|U 


scb«base+26h 


SAOVEC 


tqu 


scb*bast+2Bh 


8L0VEC 


tqu 


scb*bast+2Ah 


•BNKBF 


tqu 


scb*base+3Sh 


ICRDMA 


tqu 


scb$bate+3Ch 


SCRDSK 


tqu 


scb*basc+3Eh 


4VINF0 


tqu 


scb tba«*+3Fh 


eRESEL 


tqu 


scb»base+41h 


8FX 


tqu 


scbsbast+43h 


BUSRCD 


tqu 


scbibase+44h 


8MLT10 


tqu 


scbtba se+4Ah 


SERMDE 


tqu 


scbsbaseMDh 


8ERDSK 


tqu 


scb»base*51h 


8MEDIA 


tqu 


scb*base+54h 


8BFLGS 


tqu 


scb*base»57h 


8DATE 


tqu 


scbtbase+38h 


eHQUR 


tqu 


scb«base»SAh 


8MIN 


tqu 


scbtbase+5Bh 


esEC 


tqu 


scbtbast+SCh 


7ERJMP 


tqu 


scb«bast-t-3Fh 



scbtbase+62h 



Bast of tht SCB 

Console Input Rtdirtction 

Vtctor (uordf r/u) 

Console Output Redirection 

Vector (wordi r/u) 

Auxiliary Input Rtdirtction 

Vector (word* r/w) 

Auxiliary Output Redirection 

Vector (word, r/u) 

List Output Redirection 

Vector (word* r/u) 

Address of 128 Bytt Bufftr 

for Banked BIOS (word, r/o) 

Current DMA Address 

(word, r/o) 

Current Disk (byte, r/o) 

BD05 Variable "INFO" 

(word, r/o) 

FCB Flag (byte, r/o) 

BDOS Function for Error 

Messages (byte, r/o) 

Current User Code (byte, r/o) 

Current Multi-Sector Count 

(byte. r/u) 

BDOS Error Mode (byte, r/o) 

BDOS Error Disk (byte. r/o) 

Set by BIOS to indicate 

open door (byte.r/u) 

BDOS Message Sin Flag (byte, r/o) 

Date in Days Since 1 Jan 78 

(word, r/w) 

Hour in BCD (bytt. r/u) 

Minute in BCD (bytt. r/u) 

Second in BCD (bytt. r/u) 

BDOS Error Mtssage Jump 

(word, r/w) 

Top of User TPA 

(address at 6.7>(uord. r/o) 
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?ERJMP 


FE5F 


6 


44* 


8AIVEC 


FE26 


3 


IS* 


8A0VEC 


FEaa 


3 


17* 


eBFLCS 


FE57 


3 


33* 


8BNKBF 


FE35 


3 


21* 


BCIVEC 


FE22 


3 


11* 


ecovEc 


FE24 


3 


13* 


tCRDMA 


FE3C 


4 


23* 


ecROSK 


FE3E 


4 


23* 


8DATE 


FE58 


A 


39* 


eERDSK 


FE51 


5 


35* 


8ERMDE 


FE4D 


5 


34* 


6FX 


FE43 


4 


29* 


SHOUR 


FE5A 


6 


41* 


8L0VEC 


FE2A 


3 


19* 


8MEDIA 


FE54 


5 


3£* 


eniN 


FE5B 


b 


42* 


8MLTI0 


FE4A 


5 


32* 


enxTPA 


FE62 


6 


46* 


8RESEL 


FE41 


4 


28* 


esse 


FE5C 


6 


43* 


G'JSRCD 


FE44 


4 


31* 


fe^INFO 


FE3F 


4 


26* 
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equates for mode byte bit fields 



mbS input 
mb$output 
mbS in$out 
mb$sof t$baud 
mb$serial 
mb$xon$xof f 

baudSnone 

baud$S0 

baud$75 

baud$H0 

baud$134 

baud$150 

baud$300 

baud$600 

baud$1200 

baud$1800 

baud$2400 

baud$3600 

baud$4800 

baud$7200 

baud$9600 

baud$19200 



equ OOOOSOOOlb ; device may do input 

equ OOOOSOOlOb ; device may do output 

equ mb$input+mb$output 

equ 0000$0100b ; software selectable baud rates 

equ 0000$1000b ; device may use protocol 

equ 0001$0000b ; XON/XOFF protocol enabled 



equ 
equ 1 
equ 2 
equ 3 
equ 4 
equ 5 
equ 6 
equ 7 
equ 8 
equ 9 
equ 10 
equ 11 
equ 12 
equ 13 
equ 14 
equ 15 



no baud rate associated with device 

SO baud 

75 baud 

110 baud 

134.5 baud 

150 baud 

300 baud 

600 baud 

1200 baud 

1800 baud 

2400 baud 

3600 baud 

4800 baud 

7200 baud 

9600 baud 

19.2k baud 



Listing G-l. Equates for Mode Byte Fields: MODEBAUD . LIB 
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Macro Definitions for CP/M3 BIOS Data Structures. 

; dtbl <dphO,dphl, .. .> - drive table 

dph translate$table, - disk parameter header 
diskS parameters block, 

checksum$size, (optional) 

allocSsize (optional) 

skew sectors, - skew table 

skew$ factor , 
f Irs t$ sector $ number 

; dpb physicalSsectorSsize, - disk parameter block 
physica 1? sec tor s$per$ track, 
number$ tracks, 
block$size, 
number $di reentries, 
track$off set, 
checksum$vec$size (optional) 

; Drive Table. Contains 16 one word entries. 

dtbl macro ?list 

local ?n 
?n set 

irp ?drv,<?list> 
?n set ?n+l 

dw ?drv 

endm 

if ?n > 16 
.' Too many drives. Max 16 allowed' 
exitm 
endif 

if ?n < 16 

rept (16-?n) 
dw 
endm 
endif 
endm 

dph macro ?trans ,?dpb,?csize,?asize 
local ?csv,?alv 

dw ?trans ; translate table address 

db 0,0,0,0,0,0,0,0,0 ; BDOS Scratch area 
db ; media flag 



dw ?dpb ; disk parameter block 

if not nul Tcslze 

dw ?csv ; checksum vector 

else 

dw OFFFEh ; checksum vector allocated by GENCPM 

endif 
if not nul ?asize 

dw ?alv ; allocation vector 

else 

dw OFFFEh ; alloc vector allocated by GENCPM 

endif 

dw 0£ffeh,0fffeh,0fffeh ; dirbcb, dtabcb, hash alloc'd by GENCPM 

db ; hash bank 
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; checksum vector 
: allocation vector 



if not nul ?csize 
?csv ds ?csize 

endif 

if not nul ?asize 
?alv ds ?asize 

endif 

endm 

dpb macro ?psize,?pspt,?trks, ?bls,?ndirs,?of f ,?ncks 

local ?spt,?bsh,?blm,?exm,?dsm,?drm,?alO,?all,?cks,?psh,?psm 
local ?n 
;; physical sector mask and physical sector shift 
?psh set 
?n set ?psize/128 

?psm set ?n-l 
rept 8 

?n set ?n/2 
if ?n = 
exitm 
endif 
?psh set ?psh + 1 
endm 
?spt set ?pspt*(?psize/128) 

?bsh set 3 
?n set ?bls/1024 

rept 8 

?n set ?n/2 
if ?n = 
exitm 
endif 
?bsh set ?bsh + 1 
endm 
?blm set ?bls/128-l 
?size set (?trks-?of f ) *?spt 
?dsm set ?size/(?bls/128)-l 

?exm set ?bls/1024 
if ?dsm > 255 

if ?bls = 1024 

.'Error, can''t have this size disk with Ik block size' 
exitm 
endif 

?exm set ?exm/2 

endif 
?exm set ?exm-l 
?all set 
?n set (?ndirs*32+?bls-l)/?bls 

rept ?n 

?all set (?all shr 1) or 8000h 

endm 
?al0 set high ?all 
?all set low ?all 
?drm set ?ndirs-l 
if not nul ?ncks 



128 byte records per track 

block shift and mask 

extent mask 

maximum block number 

maximum directory entry number 

alloc vector for directory 

checksum size 

offset for system tracks 

physical sector size shift and mask 



?cks 


set ?ncks 


else 




?cks 


set ?ndirs/4 


endif 




dw 


?spt ; 


db 


?bsh,?blm ; 


db 


?exm ; 


dw 


?dsm ; 


dw 


?drm ; 


db 


?al0,?all 


dw 


?cks ; 


dw 


?off ; 


db 


?psh,?psm ; 
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gcd macro ?m,?n 

;; greatest common divisor of m,n 

;; produces value gcdn as result 
;; (used in sector translate table generation) 
?gcdm set ?m ;; variable for m 
Tgcdn set ?n j; variable for n 
?gcdr set ;; variable for r 
rept 65535 

?gcdx set ?gcdm/?gcdn 
?gcdr set ?gcdm - ?gcdx*?gcdn 
if ?gcdr = 
exitm 
endif 
?gcdm set ?gcdn 
?gcdn set ?gcdr 
endm 
en dm 

skew macro ?sec3,?skf ,?f sc 

;; generate the translate table 

?nxtsec set ;jnext sector to fill 

?nxtbas set ; j moves by one on overflow 

gcd %?secs,?skf 

1 ; ?gcdn = gcd(?secs ,skew) 

?neltst set ?secs/?gcdn 

;; neltst is number of elements to generate 

;; before we overlap previous elements 

?nelts set Tneltst ;;counter 

rept ?secs ;;once for each sector 
db ?nxtsec+?fsc 
?nxtsec set ?nxtsec+?skf 
if Tnxtsec >= ?secs 
?nxtsec set ?nxtsec-?secs 
endif 
?nelts set ?nelts-l 
if ?nelts = 



?nxtbas 


set 


?nxtbas+l 


?nxtsec 


set 


?nxtbas 


?nelts 


set 


?neltst 


endif 






endm 






endm 







Listing H-l. (continued) 
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I.l Boot Loader Module for CP/M 3 



The BOOT. ASM module performs system initialization other than 
character and disk I/O. BOOT loads the CCP for cold starts and 
reloads it for warm starts. Note that the device drivers in the 
Digital Research sample BIOS initialize devices for a polled, and 
not an interrupt-driven , environment. 

title 'Boot loader module for CP/M 3.0' 



FFFF - 
0000 - 



true equ -1 

false equ not true 



banked equ true 



tpaSbank 

e 
tpaSbank 



public ?init,?ldccp,?rlccp,?time 

extrn ?pmsg,?conin 

extrn ?civec,?covec,Saivec,§aovec,91ovec 

extrn @cbnk,?bnksl 

maclib ports 
maclib z80 

equ 5 

if banked 

equ 1 



dseg 



equ 



init done from banked memory 



0000 2101002200 lxi h,l 1 shld gcivec I shld gcovec 

0009 2102002200 lxi h,2 1 shld ?lovec 

O00F 2104002200 lxi h,4 1 shld @aivec ! shld gaovec 

0018 21EF00CD25 lxi h,init$table I call out$blocks 

001E 218700CD00 lxi h,signon$msg I call ?pmsg 

0024 C9 ret 



assign console to CRT: 
assign printer to LPT: 
assign AUX to CRT1: 
set up raise hardware 
print signon message 



0025 7EB7C847 
0029 234E23 



002C+EDB3 
002E C32500 



out$blocks: 
mov 



?ldccp: 



0000 AF32DB00 
0004 21000022EC 
000A 11CC00CD73 
0010 3CCA4A00 
0014 110001CD78 
001A 118000CD7D 
0020 11CC00CD82 



0026 2100010100 
002C 3A0000F5 



0030 3E01CD0000 
0035 7EF5 



I rz 1 mov b,a 



I ora 
Inx h I mov c 
outir 

DB 0EDH.0B3H 
jmp out$blocks 



cseg ; boot loading most be done from resident memory 

This version of the boot loader loads the CCP from a file 
called CCP.COM on the system drive (A:). 



! First time, load the 

xra a I sta ccp$fcb+15 

lxi h,0 I shld fcb$nr 

lxi d,ccp$fcb I call open 

inr a 1 jz no$CCP 

lxi d,0100h 1 call setdma 

lxi d,128 I call setmulti 

lxi d.ccpSfcb I call read 



lxi h,0100h 1 lxi b,OCO0h 
Ida ?cbnk 1 push psw 



CCP.COM file into TPA 
; zero extent 
; start at beginning of file 

open file containing CCP 

error if no file. . . 

start of TPA 

allow up to 16k bytes 

load the thing 

now, 

copy CCP to bank for reloading 

clone 3K, just in case 

save current bank 



mvi a,tpa$bank I call ?bnksl 
mov a,m 1 push psw 



select TPA 
get a byte 
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0037 
003C 
003E 
0040 
0042 
0045 
0049 



004A 
0050 
0053 



005C 
0061 
0063 
0068 
006A 
006C 
006E 
0071 



89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 

100 

101 

102 

103 

104 

105 

106 

107 

108 

109 

110 

111 

112 

113 

114 

115 

116 

117 

118 

119 

120 

121 

122 

123 

BANKED 

BC 

BDOS 

CCPFCB 

CCPMSG 

DE 

FALSE 
FCBNR 



IX 

IY 

LD1 

NOCCP 

OPEN 

OUTBLOCKS 

PBANKS ELECT 

PBAUDCON1 

PBAUDCON2 

PBAUDCON34 

PBAUDLPT1 



3EO2CD000O 

F177 

230B 

78B1 

C23000 

F1CD0000 

C9 



mvl a, 2 I call 7bnksl 

pop psw 1 mov m,a 

inx h I dcx b 

mov a,b 1 or a c 

jnz ld$l 

pop psw 1 call ?bnksl 

ret 



select extra bank 
save the byte 
bump pointer, drop count 
test for done 

restore original bank 



no$CCP: ; here if we couldn't find the file 

21AB0OCD00 lxi h,ccp$msg 1 call 7pmsg ; report this... 

CD0000 call ?conin ; get a response 

C30000 jmp ?ldccp ; and try again 



Trlccp: 

0056 2100010100 lxi h,0100h I lxi b,0C00h 

rl$l: 

3E02CD0000 mvi a, 2 ! call ?bnksl 

7EF5 mov a,m 1 push psw 

3E01CD0000 mvi a,tpa$bank I call 7bnksl 



F177 

230B 

78B1 

C25C00 

C9 



0073 0E0FC30500 



pop psw 1 mov m,a 
inx h 1 dcx b 
mov a,b I or a c 
jnz rl$l 
ret 

; No external clock. 
7time: 

ret 

; CP/M BDOS Function Interfaces 

open: 

mvi c,15 ! jmp bdos 



clone 3K 

select extra bank 

get a byte 

select TPA 

save the byte 

bump pointer, drop count 

test for done 



setdma: 
0E1AC30500 mvi c,26 ! jmp bdos 



setmulti: 
0E2CC30500 mvi c,44 1 jmp bdos 



0082 0E14C30500 



mvi c,20 1 jmp bdos 



open file control block 
set data transfer address 
set record count 
read records 



00CC 
00DC 
00EC 

00EF 
00F4 
00F9 
00FC 



0D0A0D0A43signon$msg 
0D0A42494Fccp$msg 

0143435020ccp$fcb 

000000 fcb$nr 

0326CFFF07init$table 

0327CF0007 

012500 

00 



13,10,13,10, 'CP/M Version 3.0, sample BIOS ', 13, 10,0 
13, 10, 'BIOS Err on A: No CCP.COM file',0 



', "COM" ,0,0,0,0 



db 
db 



1, 'CCP 

16 

0,0,0 

3,p$zpio$3a,0CFh,0FFh,07h ; set-up config port 
3,p$zpio$3b,0CFh,000h,07h ; set up bank port 
l,p$bank$select ,0 ; select bank C 
; end of init$table 



00FD 



FFFF 
0000 
0005 
00CC 
00AB 
0002 
0000 
00EC 
0004 
00EF 
0004 
0004 
0030 
004A 
0073 
0025 
0025 
000C 
0030 
0031 
000E 



161 

50 

73 

4» 

51 



61# 
53 
52 
30 
120 



end 



52 
111» 



72# 
96# 
341 



103 
1141 
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PBAUDLPT2 


0032 






PBOOT 


0014 






PCENTDATA 


0011 






PCENTSTAT 


0010 






PC0N2DATA 


002C 






PCON2STAT 


002D 






PC0N3DATA 


002E 






PC0N3STAT 


002F 






PC0N4DATA 


002A 






PC0N4STAT 


002B 






PCONFIGURATION 


0024 






PCRTDATA 


001C 






P CRTS TAT 


001D 






PFDCMND 


0004 






PFDDATA 


0007 






PFDINT 


0008 






PFDMISC 


0009 






PFDSECTOR 


0006 






PFDSTAT 


0004 






PFDTRACK 


0005 






PINDEX 


000F 






PLPT2DATA 


0028 






PLPT2STAT 


0029 






PLPTDATA 


001E 






PLPTSTAT 


001F 






PRTC 


0033 






PSELECT 


0008 






PWD1797 


0004 






PZCTC1 


000C 






PZCTC2 


0030 






PZDART 


001C 






PZDMA 


0000 






PZPIOl 


0008 






PZPIOIA 


OO0A 






PZPIOIB 


000B 






PZPI02 


0010 






PZPI02A 


0012 






PZPI02B 


0013 






PZPI03 


0024 






PZPI03A 


0026 


118 




PZPI03B 


0027 


119 




PZSIOl 


0028 






PZSI02 


002C 






READ 


0082 


56 


1051 


RL1 


005C 


801 


87 


SETDMA 


0078 


54 


991 


SETHULTI 


007D 


55 


1021 


SIGNONMSG 


0087 


31 


1091 


TPABANK 


0001 


191 


211 62 


TRUE 


FFFF 


31 


4 6 


7BNKSL 


0000 


11 


62 64 


? CON IN 


0000 


9 


74 


?INIT 


0000 


8 


261 


7LDCCP 


0000 


8 


481 75 


7PMSG 


0000 


9 


31 73 


7RLCCP 


0056 


8 


781 


TTIME 


0072 


8 


91t 


0AIVEC 


0000 


10 


29 


gAOVEC 


0000 


10 


29 


gCBNK 


0000 


11 


60 


@CIVEC 


0000 


10 


27 


0COVEC 


0000 


10 


27 


@LOVEC 


0000 


10 


28 
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1.2 Character I/O Handler for Z80 Chip-based System 

The CHARIO.ASM module performs all character device 
initialization, input, output, and status polling. CHARIO contains 
the character device characteristics table. 

1 title 'Character I/O handler for z80 chip based system' 

; Character I/O for the Modular CP/M 3 BIOS 
; limitations: 



2 






3 






4 






5 






6 






7 






8 






9 






10 






11 






12 






13 






14 






15 






16 






17 






18 






19 






20 






21 






22 






23 


0006 


= r 


24 






25 






26 






27 






28 


0000 


79FE06CA42 


29 


0006 


DO 


30 


0007 


692600 


31 


000A 


E5 


32 


000B 


292929 


33 


000E 


11E900196E 


34 


0013 


7DFE07 


35 


0016 


3E44D21D00 


36 


001B 


3EC4 


37 




I 


38 


001D 


323501 


39 


0020 


2600111B01 


40 


0026 


7E322E01 


41 


002A 


El 


42 


002B 


11DC0019 


43 


002F 


7E3C323001 


44 


0034 


11FAFF19 


45 


0038 


7E322C01 


46 


003C 


212B01 


47 


003F 


C34500 


48 






49 




< 


50 


0042 


213901 


51 






52 






53 


0045 


7EB7C8 


54 


0048 


47234E23 


55 






56 


004C+EDB3 


57 


004E 


C34500 


58 






59 






60 






61 






62 


0051 


78FE06D263 


63 






64 


0057 


CD6600CA57 


65 


005D 


0D 


66 


005E+ED78 


67 


0060 


E67F 



baud rates 19200,7200,3600,1800 and 134 
are approximations. 



9600 is the maximum baud rate that is likely 
to work. 



baud rates 50, 75, and 110 are not supported 



public ?cinit,?ci,7co,7cist,7cost 
public gctbl 



maclib Z80 
maclib ports 
maclib modebaud 



define Z80 op codes 

define port addresses 

define mode bits and baud equates 



max$devices 



equ 6 



hi$speed: 



mov a,c I cpi max$devices I j 
rnc 

mov l,c 1 mvi h,0 
push h 
dad h I dad h I dad h 
lxi d,§ctbl+7 ! dad d 1 mov 1, 
mov a,l 1 cpi baud$600 
mvi a,44h 1 jnc hi$speed 
mvi a,0C4h 
i: 

sta slo$reg$4 
mvi h,0 1 lxi d,speed$table 1 
mov a,m 1 sta speed 
.pop h 

lxi d,data$ports 1 dad d 
mov a,m 1 inr a 1 sta sio$porl 
lxi d,baud$ports-data$ports 1 
mov a,m 1 sta ctc$port 
1x1 h,serial$init$tbl 
jmp stream$out 



z cent$init ; init parallel printer 
! invalid device 

; make 16 bits from device number 
; save device in stack 



get baud rate 
see if baud > 300 
if >■ 600, use *16 mode 
else, use *64 mode 



dad d ; point to counter entry 

; get and save etc count 

j recover 

; point at SIO port address 

; get and save port 
dad d ; offset to baud rate port 

; get and save 



cent$ init: 

lxi h,pio$init$tbl 

streamSout: 

mov a,m f ora a I rz 

mov b,a ! inx h I mov c,m 1 inx h 

outir 

DB 0EDH,0B3H 

jmp stream$out 



j character input 
mov a,b ! cpi 6 1 jnc null$ input ; can't read from Centronics 



68 0062 C9 

Listing 1-2. 



call 7cist I jz cil 

dcr c 1 inp a 

DB 0EDH,A*8+40H 

ani 7Fh 

ret 



; wait for character ready 
; get data 



; mask parity 
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0063 3E1A 
0065 C9 



null$ input: 

mvl a,lAh 
ret 



0066 78FE06D27D 
006C 682600 
006F HDC0019 
0073 4E0C 

0075+ED78 
0077 E601 
0079 C8 
007A F6FF 
007C C9 



; return a ctl-Z for no device 



; character input status 

mov a,b I cpi 6 I jnc null$status ; can't read from Centronics 

mov l,b I mvi h,0 ; make device number 16 bits 

lxi d,data$ports 1 dad d ; make pointer to port address 

mov c,m 1 inr c ; get SIO status port 

inp a ; read from status port 

DB 0EDH,A*8+40H 

ani 1 ; isolate RxRdy 

rz ; return with zero 

ori OFFh 

ret 



null$status: 
xra 



a t ret 



98 
99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 



?co: ; character output 

007F 78FE06CA9E mov a,b 1 cpi 6 1 jz centronicsSout 

0085 D29D00 jnc null$output 

0088 79F5 mov a,c 1 push psw 

008A C5 push b 



008B CDB300CA8B 
0091 E16C2600 
0095 11DC0019 
0099 4E 
009A Fl 
009B+ED79 

009D C9 



co$spin: 



save character from <C> 
save device number 



null$output: 
ret 



call 7cost I jz coSspin 
pop h 1 mov l,h 1 mvi h,0 
lxi d,data$ports I dad d 
mov c,m 
pop psw 1 outp a 

0EDH,A*8+41H 



wait for TxEmpty 

get device number in <HL> 

make address of port address 

get port address 

send data 



centronicsSout: 



009E DB10E620C2 
00A5 79D311 
00A8 DB10F601D3 
00AE E67ED310 
00B2 C9 



00B3 78FE06CACD 
O0B9 D27D00 
00BC 682600 
00BF 11DC0019 
00C3 4E0C 

O0C5+ED78 
00C7 E604C8 
00CA F6FFC9 



in pScentstat 1 ani 20h 1 jnz centronicsSout 

mov a,c I out p$centdata ; give printer data 

in p$centstat 1 ori 1 ! out p$centstat ; set strobe 

ani 7Eh I out p$centstat ; clear strobe 

ret 



; character output status 
mov a,b 1 cpi 6 I jz cent$stat 
jnc null$status 
mov l,b 1 mvi h,0 
lxi d.dataSports 1 dad d 
mov c,m I inr c 

inp a ; 

DB 0EDH,A*8+40H 
ani 4 1 rz ; 

ori OFFh I ret ; 



get input status 



test transmitter empty 
return true if ready 



00CD DB102F 
00D0 E620C8 
00D3 F6FFC9 



00D6 0C0E3031 
00DA 3132 



00DC 1C1E2C2E 
0OE0 2A28 



centSstat: 

in p$centstat I cma 
ani 20h 1 rz 
ori OFFh 1 ret 

baud$ports: ; CTC ports by physical device number 

db p$baud$conl,p$baud$lptl,p$baud$con2,p$baud$con34 
db p$baud$con34,p$baud$lpt2 

data$ports: ; serial base ports by physical device number 

db p$crt$data,p$lpt$data,p$con2data,p$con3data 
db p$con4data,p$lpt2data 



00E2 4352542020@ctbl 

00E8 OF 

00E9 0E 

00EA 4C50542020 

00F0 IF 

00F1 0E 

00F2 4352543120 

OOFS OF 

00F9 0E 

00FA 4352543220 

0100 OF 

0101 0E 



db 'CRT • ; device 0, CRT port 

db mb$in$out+mb$serial+mb$sof tbaud 

db baud$9600 

db 'LPT ' ; device 1, LPT port 

db mb$in$out+mb$serial+mb$sof tbaud+mbSxonxof f 

db baud$9600 

db 'CRT1 ' ; device 2, CRT port 1 

db mb$in$out+mb$serial+mb$sof tbaud 

db baud$9600 

db 'CRT2 ' ; device 3, CRT port 2 

db mb$in$out+mb$serial+mb$sof tbaud 

db baud$9600 
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0102 
0108 
0109 
010A 
0110 
0111 
0112 
0118 
0119 
011A 



011B 



012B 
012C 
01 2D 
012E 
012F 
0130 
0131 
0135 
0136 
0138 

0139 
013D 
0142 

0143 



150 

151 

152 

153 

154 

155 

156 

157 

158 

159 

160 

161 

162 

163 

164 

165 

166 

167 

168 

169 

170 

171 

172 

173 

174 

175 

176 

177 

178 

179 

180 
BAUD110 
BAUD1200 
BAUD13 4 
BAUD150 
BAUD1800 
BAOD19200 
BAUD2400 
BAUD300 
BAUD3600 
BAUD4800 
BAUD 50 
BAUD600 
BAUD7200 
BAUD75 
BAUD9600 
BAUDNONE 
BAUDPORTS 
BC 

CENTINIT 
CENTRONICSOUT 
CENTSTAT 
CI1 

COSPIN 
CTCPORT 
DATAPORTS 
DE 

HISPEED 
HL 
IX 
IY 

MAXDEVICES 
MBINOUT 
MB INPUT 
MBOUTPUT 
MBSERIAL 
MBSOFTBAUD 
MBXONXOFF 
NULLINPUT 
NULLOUTPUT 
NULLSTATUS 
PBANKSELECT 
PBAUDCON1 
PBAUDCON2 
PBAUDCON34 
PBAUDLPT1 
PBAUDLPT2 
PBOOT 
PCENTDATA 
PCENTSTAT 
PCON2DATA 



4352543320 

OF 

OE 

5641582020 

OF 

OE 

43454E2020 

02 

00 

00 



db 'CRT3 ' ; device 4, CRT port 3 

db mb$in$out+mb$serial+mb$ soft baud 

db baud$9600 

db 'VAX ' ; device 5, LPT port 1 used for VAX interface 

db mb$in$out+mb$serial+mb$sof tbaud 

db baud$9600 

db 'CEN ' ; device 6, Centronics parallel printer 

db mb$output 

db baud$none 

db ; table terminator 



00FFFFFFE9speed$table db 

serial$ initStbl 
02 

ctc$port 

speed 

sioSport 

sio$reg$4 



0,255,255,255,233,208,104,208,104,69,52,35,26,17,13,7 



47 



1803E104 



5EA 
00 

02130F07 pio$init$tbl 

0312CFF807 

00 



0003 
0008 
0004 
0005 
0009 
000F 
000A 
0006 
000B 
000C 
0001 

0007 34 
000D 

0002 

000E 140 

0000 158 

00D6 44 

0000 

0042 28 

009E 91 

00CD 113 

0057 63# 

008B 951 

012C 45 

00DC 42 

0002 

001D 35 

0004 

0004 

0004 

0006 231 

0003 139 
0001 

0002 157 

0008 139 

0004 139 

0010 142 
0063 62 
009D 92 
007D 76 
0025 

000C 130 

0030 130 

0031 130 
000E 130 

0032 131 
0014 

0011 107 
0010 106 
002C 134 



db 2 

ds 1 

db 47h 

ds 1 

db 7 

ds 1 

db 18h,3,0Elh,4 

ds 1 

db 5,0EAh 

db 



two bytes to CTC 
port address of CTC 
CTC mode byte 
baud multiplier 
7 bytes to SIO 
port address of SIO 



db 
db 
db 



2,p$zpio$2b,0Fh,07h 
3,p$zpio$2a,0CFh,0F8h,07h 



129# 

49t 

1051 
124# 

64 

96 
1661 

44 

371 



28 
142 



142 
142 

70# 

1021 

871 



145 
145 



148 
148 



151 
151 



154 
154 



108 108 109 



Listing 1-2. (continued) 



Ail Information Presented Here is Proprietary to Digital Research 

142 



CP/M 3 System Guide 



1.2 Character I/O Handler 



PCON2STAT 


002D 






PCON3DATA 


002E 


134 




PCON3STAT 


002F 






PCCN4DATA 


002A 


135 




PCON4STAT 


002B 






PCONFIGU RATION 


0024 






P COT DATA 


00 1C 


134 




PCRTSTAT 


001D 






PFDCMND 


0004 






P FDD ATA 


0007 






PFDINT 


0008 






PFDMISC 


0009 






PFDSECTOR 


0006 






PFDSTAT 


0004 






PFDTRACK 


0005 






PINDEX 


000F 






PIOINITTBL 


0139 


50 


176t 


PLPT2DATA 


0028 


135 




PLPT2STAT 


0029 






PLPTDATA 


001E 


134 




PLPTSTAT 


001F 






PRTC 


0033 






PSELECT 


0008 






PWD1797 


0004 






PZCTC1 


oooc 






PZCTC2 


0030 






PZ DART 


001C 






PZDMA 


0000 






PZPIOl 


0008 






PZPIOIA 


000A 






PZPIOIB 


000B 






PZPI02 


0010 






PZPI02A 


0012 


177 




PZPI02B 


0013 


176 




PZPI03 


0024 






PZPI03A 


0026 






PZPI03B 


0027 






PZSIOl 


0028 






PZSI02 


002C 






SERIALINITTBL 


012B 


46 


1641 


SIOPORT 


0130 


43 


1701 


SI0REG4 


0135 


38 


1721 


SPEED 


012E 


40 


168# 


SPEEDTABLE 


011B 


39 


1621 


STREAMOUT 


0045 


47 


52» 57 


?CI 


0051 


16 


601 


?CINIT 


0000 


16 


27# 


?CIST 


0066 


16 


64 741 


?C0 


007F 


16 


90* 


?COST 


00B3 


16 


96 1121 


@CTBL 


00E2 


17 


33 138* 



Listing 1-2. (continued) 



All Information Presented Here is Proprietary to Digital Research 

143 



CP/M 3 System Guide 



1.3 Drive Table 



1.3 Drive Table 

The DRVTBL.ASM module points to the data structures for each 
configured disk drive. The drive table determines which physical 
disk unit is associated with which logical drive. The data 
structure for each disk drive is called an Extended Disk Parameter 
Header (XDPH) . 



public Gdtbl 
extrn fdsdO,fdsdl 



FDSDO 
FDSD1 
gDTBL 



0000 00000000 Gdtbl 
0004 0000000000 



dw fdsdO.fdsdl 

dw 0,0,0,0,0,0,0,0,0,0,0,0,0,0 



drives C-P non-existent 



0000 


2 


6 


0000 


2 


6 


0000 


1 


et 



Listing 1-3. Drive Table 



1.4 Z80 DMA Single-density Disk Handler 

The FD1797SD module initializes the disk controllers for the 
disks described in the Disk Parameter Headers and Disk Parameter 
Blocks contained in this module. FD1797SD is written for hardware 
that supports Direct Memory Access (DMA) . 



title 'wdl797 w/ Z80 DMA Single density diskette handler' 

CP/M-80 Version 3 — Modular BIOS 

; Disk I/O Module for wdl797 based diskette systems 

; Initial version 0.01, 

; Single density floppy only. - jrp, 4 Aug 82 

dseg 
; Disk drive dispatching tables for linked BIOS 

public fdsd0,fdsdl 

; Variables containing parameters passed by BDOS 

extrn 9adrv,@rdrv 
extrn §dma ,@trk ,?sect 
extrn @dbnk 

; System Control Block variables 

extrn germde ; BDOS error mode 

; Utility routines in standard BIOS 

Listing 1-4. Z80 DMA Single-density Disk Handler 
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extrn ?wboot ; warm boot vector 

extrn ?pmsg ; print message §<HL> up to 00, saves <BC> & <DE> 

extrn ?pdec ; print binary number in <A> from to 99. 

extrn ?pderr ; print BIOS disk error header 

extrn ?conin,?cono j con in and out 

extrn ?const ; get console status 



; Port Address Equates 

maclib ports 
; CP/M 3 Disk definition macros 

maclib cpm3 
; Z80 macro library Instruction definitions 

maclib z80 
; common control characters 



49 








50 


000D = 


cr 


equ 13 


51 


000A = 


If 


equ 10 


52 


0007 = 


bell 


equ 7 



Extended Disk Parameter Headers (XPDHs) 



70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
100 
101 
102 
103 
104 



0000 E600 
0002 DC00 
0004 DB00 
0006 BE00 
0008 0000 

fdsdO 
000A+A400 
000C+0000000000 
0015+00 
0016+0000 
0018+2300 
001A+3300 
001C+FEFFFEFFFE 
0022+00 

0023+ 770001 

0033+ 770002 

0052 E600 
0054 DC00 
0056 DB00 
0058 CD00 
005A 0100 

fdsdl 
005C+A400 
005E+0000000000 
0067+00 
0068+0000 
006A+7500 
006C+8500 
006E+FEFFFEFFFE 
0074+00 

0075+ 770003 

0085+ 770004 



0000+1AOO 

0002+0307 

0004+00 

0005+F200 

0007+3FOO 

0009+COOO 

000B+1000 

000D+0200 

000F+0000 



dpbsd 



dw fdSwrit'e 
dw fd$read 
dw fd$ login 
dw fd$init0 
db 0,0 

trans, dpbsd, 16, 31 



dph 

DW TJIANS 

DB 0,0,0,0,0,0,0,0,0 

DB 

DW DPBSD 

DW 770001 

DW 770002 

DW 0FFFEH,0FFFEH,0FFFEH 

DB 

DS 16 

DS 31 

dw 

dw 

dw 

dw 

db 

dph 

DW TRANS ; 

DB 0,0,0,0,0,0,0,0,0 ; 

DB ; 

DW DPBSD 

DW 770003 

DW 770004 

DW OFFFEH.OFFFEH.OFFFEH ; 

DB 



relative drive zero 

TRANSLATE TABLE ADDRESS 
BDOS SCRATCH AREA 
MEDIA FLAG 

; DISK PARAMETER BLOCK 

; CHECKSUM VECTOR 

; ALLOCATION VECTOR 
DIRBCB, DTABCB, HASH ALLOC D BY GENCPM 
HASH BANK 
CHECKSUM VECTOR 



; ALLOCATION VECTOR 



fd$write 

fd$read 

fd$login 

fd$initl 

1.0 

trans, dpbsd, 16, 31 



DS 



relative drive one 

TRANSLATE TABLE ADDRESS 
BDOS SCRATCH AREA 
MEDIA FLAG 

; DISK PARAMETER BLOCK 

( CHECKSUM VECTOR 

; ALLOCATION VECTOR 
DIRBCB, DTABCB, HASHALLOC'D BY GENCPM 
HASH BANK 
CHECKSUM VECTOR 
ALLOCATION VECTOR 



DPB must be resident 



cseg 

dpb 128,26,77,1024,64, 

DW 770005 

DB 770006,770007 

DB 770008 

DW 770009 

DW 770010 

DB 770011,770012 

DW 770013 

DW 2 

DB 770014,770015 



; 128 BYTE RECORDS PER TRACK 

; BLOCK SHIFT AND MASK 

! EXTENT MASK 

j MAXIMUM BLOCK NUMBER 

) MAXIMUM DIRECTORY ENTRY NUMBER 

; ALLOC VECTOR FOR DIRECTORY 

; CHECKSUM SIZE 

; OFFSET FOR SYSTEM TRACKS 

1 PHYSICAL SECTOR SIZE SHIFT AND MASK 



dseg 



; rest is banked 
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105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 



O0A4+O1 
00A5+07 
00A6+0D 
O0A7+13 
O0A8+19 
00A9+05 
00AA+0B 
00AB+11 
00AC+17 
00AD+03 
00AE+09 
OOAF+OF 
00B0+15 
00B1+02 
00B2+08 
00B3+0E 
00B4+14 
00B5+1A 
O0B6+O6 
00B7+0C 
O0B8+12 
00B9+18 
OOBA+04 
00BB+OA 
OOBC+10 
00BD+16 



OOBE 21CE00 



00C1 7EB7C8 
00C4 47234E23 



00C8+EDB3 
OOCA C3C100 



OOCD C9 

OOCE 040A 
OODO CFC217FF 
00D4 040B 
00D6 CFDD17FF 
OODA 00 



skew 26,6,1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 

DB 7NXTSEC+1 



; Disk I/O routines for standardized BIOS interface 
; Initialization entry point. 
; called for first time initialization. 



fdSinitO: 

lxi h,init$table 
fd$init$next: 

mov a,m 1 ora a 1 rz 

mov b,a 1 inx h I mov c,m I inx h 

outir 

DB OEDH,0B3H 

jmp fd$init$next 



fd$initl: 

ret 



init$ table 



fd$ login: 



; all initialization done by drive 



db 4,p$zpio$lA 

db 11001111b, 11000010b, 00010111b, 11111111b 

db 4,p$zpio$lB 

db 11001111b, 11011101b, 00010111b, 11111111b 

db 



; This entry is called when a logical drive is about to 

; be logged into for the purpose of density determination. 

; It may adjust the parameters contained in the disk 

; parameter header pointed at by <DE> 

; we have nothing to do in 

; simple single density only environment. 



disk READ and WRITE entry points. 



; these entries are called with the following arguments: 

; relative drive number in @rdrv (8 bits) 

; absolute drive number in @adrv (8 bits) 

; disk transfer address in gdma (16 bits) 

; disk transfer bank in gdbnk (8 bits) 

; disk track address in @trk (16 bits) 

; disk sector address in jjsect (16 bits) 

; pointer to XDPH in <DE> 



Listing 1-4. (continued) 



All Information Presented Here is Proprietary to Digital Research 

146 



CP/M 3 System Guide 



1.4 Z80 DMA Single-density Disk Handler 



185 
186 
187 
188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 
263 



> they transfer the appropriate data, perform retries 
; if necessary, then return an error code in <A> 



00DC 211802 
00DF 3E880601 
O0E3 C3ED00 



00E6 211F02 
00E9 3EA80605 



lxi h,read$msg 

mvi a,88h I mvi b,01h 

jmp rw$common 



lxi h,write$msg 

mvi a,0A8h I mvi b,05h 

jmp wrScommon 



rw$common: 



; point at " Read " 

; 1797 read + Z80DMA direction 



point at " Write " 

1797 write + Z80DMA direction 



; seek to correct track (if necessary), 
; initialize DMA controller, 
; and issue 1797 command. 



00ED 222702 
0OFO 321102 
00F3 7832A802 
00F7 2A0000229F 
O0FD 3A00006F26 
0103 11160219 
0107 7E321202 
010B D308 

010D 0E0A 

010F C5 

0110 3A12022113 

0117 77 

0118 C22D01 

011B 3A00002114 

0122 77 

0123 C22D01 

0126 DB09E602C2 



shld operatlon$name 
sta disk$command 
mov a,b 1 sta zdma$direction 
lhld @dma 1 shld zdmaSdma 
Ida ?rdrv I mov l,a 1 mvi h,0 
lxi d,select$table 1 dad d 
mov a,m 1 sta select$mask 
out p$select 



moreSretries: 

mvi c,10 

retry$operation: 
push b 



; save message for errors 

j save 1797 command 

; save Z80DMA direction code 

j get and save DMA address 

; get controller-relative disk drive 

; point to select mask for drive 

; get select mask and save it 

; select drive 

; allow 10 retries 

; save retry counter 



012D CDA901 
0130 011B41 

0133 0B 

0134 78B1 
0136 C23301 



Ida select$mask 1 lxi h,old$select 1 cmp m 

mov m,a 

jnznew$ track ; if not same drive as last, seek 

Ida §trk ! lxi h,old$track 1 cmp m 

mov m,a 

jnz new$track ; if not same track, then seek 

in p$fdmisc I ani 2 1 jnz sameStrack ; head still loaded, we are OK 

new$track: ; or drive or unloaded head means we should . . . 

call check$seek ; . . read address and seek if wrong track 



0139 3A0000D305 
013E 3A0000D306 

0143 219A02 
0146 010011 

0149+EDB3 

014B DB25 
014D E63F47 
0150 3AOO000FOF 
0155 E6C0B0 
0158 D325 

015A 3A1102 
015D CDD501 
0160 321502 

0163 CI 

0164 B7C8 

0166 E610 
0168 C4A901 

016B 0DC20F01 



016F 3A000OFEFF 



lxi b, 16667 
spin$loop: 

dcx b 

mov a,b 1 ora c 

jnz spin$loop 



same$track: 

Ida ?trk I out p$fdtrack 
Ida gsect 1 out p$fdsector 



; 100 ms / (24 t states*250 ns) 
t wait for head/seek settling 



; give 1797 track 
; and sector 



; point to dma command block 



lxi h,dma$block 

lxi b,dmab$length*256 + p$zdma ; command block length and port address 

outir 

DB 0EDH,0B3H 



; send commands to Z80 DMA 



in p$bankselect 
ani 3Fh 1 mov b,a 
Ida gdbnk 1 rrc 1 rrc 
ani OCOh 1 ora b 
out pSbankselect 

Ida disk$command 
call exec$command 
sta disk$status 

pop b 

ora a 1 rz 

ani 0001$0000b 
cnz check$seek 



1 get old value of bank select port 

j mask off DMA bank and save 

! get DMA bank to 2 hi-order bits 

; merge with other bank stuff 

; and select the correct DMA bank 

j get 1797 command 

t start it then wait for IREQ and read status 

I save status for error messages 

; recover retry counter 

( check status and return to BDOS if no error 

; see if record not found error 

I if a record not found, we might need to seek 



dcr c I jnz retry$operation 
; suppress error message if BDOS is returning errors to application. 
Ida @ermde I cpl OFFh 1 jz hard$error 
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264 
265 
266 
267 
268 
269 
270 
271 
272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
2 84 
285 
286 
287 
288 
289 
290 
291 
292 
293 
294 
295 
296 
297 
298 
299 
300 
301 
302 
303 
304 
305 
306 
307 
308 
309 
310 
311 
312 
313 
314 
315 
316 
317 
318 
319 
320 
321 
322 
323 
324 
325 
326 
327 
328 
329 
330 
331 
332 
333 
334 
335 
336 
337 
338 
339 
340 
341 
342 



0177 
017A 



0180 
0183 

0186 
018A 
018C 
0191 

0195 
019B 
019E 



CD00OO 
2A2702CD00 



3A1502 
212902 

e 
5E235623 
87F5 

EBDC0000EB 
F1C28601 

218A02CDOO 

CDF501 

FE59CA0D01 



; Had permanent error, print message like: 

; BIOS Err on d: T-nn, S-mm, <operation> <type>. Retry ? 
call ?pderr ; print message header 

lhld operationSname ! call ?pmsg ; last function 

; then, messages for all indicated error bits 



Ida disk$status 
lxi h,error$table 



; get status byte from last error 

; point at table of message addresses 



01A3 3E01C9 



mov e,m 1 inx h I mov d,m ! inx h ; get next message address 

add a ! push psw ; shift left and push residual bits with status 

xchg 1 cc 7pmsg t xchg ; print message, saving table pointer 

pop psw ! jnz errml ; if any more bits left, continue 

lxi h,error$msg 1 call 7pmsg ; print "<BEL>, Retry (Y/N) 7 " 

call uSconinSecho ; get operator response 

cpi 'V 1 jz more$retrles j Yes, then retry 10 more times 

hardSerror: ; otherwise, 

mvi a,l 1 ret ; return hard error to BDOS 



cancel: > here to abort job 

C30000 jmp 7wboot j leap directly to warmstart vector 



t subroutine to seek if on wrong track 

; called both to set up new track or drive 



01A9 C5 
01AA CDE101 
01AD CABE01 
01B0 CDCE01 
01B3 CDE101 
01B6 CABE01 
01B9 CDD301 
01BC 0600 

01BE 78D305 
01C1 3A00OOB8C1 
01C7 D307 
01C9 3E1A 
01CB C3D501 



id$ok: 



push b 
call read$id 
jz id$ok 
call step$out 
call read$id 
jz id$ok 
call restore 
mvi b,0 

mov a,b I out p$fdtrack 

Ida @trk I cmp b I pop b I rz 

out p$fddata 

mvi a, 00011010b 

jmp exec$command 



step$out: 
01CE 3E6A mvi a, 01101010b 

01D0 C3D501 jmp exec$command 



mvi a, 00001011b 
jmp exec$ command 



save error counter 

try to read ID, put track in <B> 

if OK, we're OK 

else step towards Trk 

and try again 

if OK, we're OK 

else, restore the drive 

and make like we are at track 

send current track to track port 
if its desired track, we are done 
else, desired track to data port 
seek w/ 10 ms. steps 



; step out once at 10 ms. 



; restore at 15 ms 



execScommand: ; issue 1797 command, and wait for IREQ 

; return status 
01D5 D304 out p$fdcmnd ; send 1797 command 

waitSIREQ: ; spin til IREQ 

01D7 DB08E640CA in pSfdint 1 ani 40h 1 jz wait$IREQ 



01DE DB04 
01E0 C9 



01E1 21AB02 
01E4 01000F 

01E7+EDB3 
01E9 3EC4 
01EB CDD501 
01EE E69D 
01F0 21110046 
01F4 C9 



in pSfdstat 
ret 



get 1797 status and clear IREQ 



lxi h,read$id$block j set up DMA controller 

lxi b,length$id$dmab*256 + p$zdma ; for READ ADDRESS operation 

outir 

DB 0EDH.0B3H 

mvi a, 11000100b ; issue 1797 read address command 

call exec$command ; wait for IREQ and read status 

ani 10011101b ; mask status 

lxi h,id$buffer 1 mov b,m ; get actual track number in <B> 

ret ; and return with Z flag true for OK 
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343 
344 
345 
346 
347 
348 
349 
3 50 
351 
352 
353 
354 
355 
356 
357 
358 
359 
360 
361 
362 
363 
364 
365 
366 
367 
368 
369 
370 
371 
372 
373 
374 
375 
376 
377 
378 
379 
380 
381 
382 
383 
384 
385 
386 
387 
388 
389 
390 
391 
392 
393 
394 
395 
396 
397 
398 
399 
400 
401 
402 
403 
404 
405 
406 
407 
408 
409 
410 
411 
412 
413 
414 
415 
416 
417 
418 
419 
420 
421 
422 
423 



u$conlnSecho; 



get console input, echo It, and shift to upper case 



01F5 CD0O00B7CA call ?const 1 ora a 1 jz u$cl ; see if any char already struck 

01FC CD0000C3F5 call ?conin 1 jmp u$conin$echo ) yes, eat it and try again 

u$cl: 

0202 CD0000F5 call ?conin 1 push psw 

0206 4FCDOO0O mov c,a I call 7cono 

020A F1FE61D8 pop psw I cpi 'a' 1 re 

020E D620 sui 'a'-'A' 

0210 C9 ret 



I make upper case 



0211 
0212 
0213 
0214 

0215 



disk$command 
select$mask 
old$select 
old$track 

diskSstatus 

selects table 



1 i current wdl797 command 

1 i current drive select code 

1 i last drive selected 

1 i last track seeked to 

1 i last error status code for messages 

0001$0000b,0010$0000b j for now use drives C and D 



error message components 



0218 2C20526561read$msg 
021F 2C20577269wrlte$msg 



db 
db 



operation$name dw 



', Read',0 
• , Write' ,0 



read$msg 



table of pointers to error message strings 

first entry is for bit 7 of 1797 status byte 



0229 3902 
022B 4502 
022D 4F02 
022F 5702 
0231 6A02 
0233 7002 
0235 7C02 
0237 8302 



error$table 



0239 
0245 
024F 
0257 
026A 
0270 
027C 
0283 



204E6F7420b7$msg 
2050726F74b6$msg 
204661756Cb5$msg 
205265636Fb4$msg 
204352432Cb3$msg 
204C6F7374b2$msg 
2044524551bl$msg 
2042757379b0$msg 



db 
db 
db 
db 
db 



028A 2052657472error$msg 



b7$msg 
b6$msg 
b5$msg 
b4$msg 
b3$msg 
b2$msg 
bl$msg 
b0$msg 

' Not ready, ' , 

' Protect, ',0 

■ Fault, ' ,0 

' Record not found,', 

1 CRC,',0 

' Lost data, ' ,0 

' DREQ, ' , 

' Busy, ' , 

• Retry (Y/N) ? ',0 



command string for Z80DMA device for normal operation 



029A C3 
029B 14 
029C 28 
029D 8A 
029E 79 
029F 

02A1 7F00 
02A3 85 
02A4 07 
02A5 CF 
02A6 05 
02A7 CF 
02A8 
02A9 CF 
02AA 87 
0011 = 



02AB C3 
02AC 14 
02AD 28 
02AE 8A 
02AF 7D 
02B0 1100 
02B2 0500 



zdma$direction 
dmab$length 

read$id$block 



db 
db 
db 
db 
db 
ds 



db 
db 



db 
db 
db 
db 
db 
dw 
dw 



0C3h 

14h 

28h 

8Ah 

79h 

2 

128-1 

85h 

p$fddata 

OCFh 

05h 

OCFh 

1 

OCFh 

87h 



reset DMA channel 
channel A is incrementing memory 
channel B is fixed port address 
RDY is high, CE/ only, stop on EOB 
program all of ch. A, xfer B->A (temp) 
starting DMA address 
128 byte sectors in SD 

xfer byte at a time, ch B is 8 bit address 
; ch B port address (1797 data port) 
load B as source register 
xfer A->B 

load A as source register 
either A->B or B->A 
load final source register 
enable DMA channel 



$-dma$block 



0C3h ; reset DMA channel 

14h j channel A is incrementing memory 

28h ; channel B is fixed port address 

8Ah ( RDY is high, CE/ only, stop on EOB 

7Dh ; program all of ch. A, xfer A->B (temp) 

id$buffer ; starting DMA address 

6-1 ; Read ID always xfers 6 bytes 
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424 02B4 


85 








425 02BS 


07 








426 02B6 


CF 






< 


427 02B7 


01 








428 02B8 


CF 








429 02B9 


87 








430 000F 


■ 


length$id$draab 


431 










432 






cseg 


433 










434 0011 




id$ buffer 


< 


435 






; tracK 


436 






1 s 


Ide 


437 






; sector 


438 






; 1 


ength 


439 






; CRC 1 


440 






; CRC 2 


441 










442 0017 






end 




BOMSG 


0283 


381 


3901 




B1MSG 


027C 


380 


389# 




B2MSG 


0270 


379 


3881 




B3HSG 


026A 


378 


3870 




B4MSG 


0257 


377 


386J 




B5MSG 


024F 


376- 


3851 




B6MSG 


0245 


375 


3841 




B7MSG 


0239 


374 


3831 




BC 


0000 








BELL 


0007 


521 






CANCEL 


01A6 


2891 






CHECKSEEK 


01A9 


226 


257 


2961 


CR 


OO0D 


501 






DE 


0002 








DISKCOMMAND 


0211 


203 


249 


3541 


DISKSTATUS 


0215 


251 


275 


3591 


DMAB LENGTH 


0011 


239 


4131 




DHABLOCK 


02 9A 


238 


3981 


413 


DPBSD 


0000 


62 


66 


79 


ERRM1 


0186 


2771 


281 




ERRORMSG 


028A 


283 


3921 




ERRORTABLE 


0229 


276 


3741 




E.XECCOMMAND 


01D5 


250 


310 


316 


FDINIT0 


00BE 


60 


1438 




FDINIT1 


OOCD 


77 


1521 




FDINITNEXT 


00C1 


1451 


150 




FDLOGIN 


OODB 


59 


76 


1621 


F DREAD 


OODC 


58 


75 


1881 


FDSD0 


000A 


14 


621 




FDSD1 


005C 


14 


791 




FDWRITE 


00E6 


57 


74 


1931 


HARDERROR 


01A3 


263 


2861 




HL 


0004 








IDBUFFER 


0011 


339 


422 


4341 


IDOK 


01BE 


299 


302 


3051 


INITTABLE 


OOCE 


144 


1551 




IX 


0004 








IY 


0004 








LENGTHIDDMAB 


OOOF 


333 


4301 




LF 


000A 


511 






MORE RETRIES 


010D 


2101 


285 




NEWT RACK 


012D 


217 


221 


2251 


OLDSELECT 


0213 


215 


3561 




OLDTRACK 


0214 


219 


3571 




OPERATION NAME 


0227 


202 


271 


3691 


PBANKSELECT 


0025 


243 


247 




PBAUDCON1 


OOOC 









db 


85h 


db 


p$fddata 


db 


OCFh 


db 


Olh 


db 


OCFh 


db 


87h 


equ 


$-read$i 



byte x£er, ch B is 8 bit address 
; ch B port address (1797 data port) 
load dest (currently source) register 
xfer B->A 

load source register 
enable DMA channel 



easier to put ID buffer in common 
s 6 ; buffer to hold ID field 
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PBAUDC0N2 


0030 








PBAUDCON3 4 


0031 








PBAUDLPT1 


000E 








PBAUDLPT2 


0032 








PBOOT 


0014 








PCENTDATA 


0011 








PCENTSTAT 


0010 








P CON 2 DATA 


002C 








PC0N2STAT 


002D 








P CON 3 DATA 


002E 








PC0N3STAT 


002F 








P CON 4 DATA 


002A 








PC0N4STAT 


002B 








PCONFIGU RATION 


0024 








PCRTDATA 


001C 








PCRTSTAT 


001D 








PFDCMND 


0004 


325 






PFDDATA 


0007 


308 


406 


425 


PFDINT 


0008 


327 






PFDMISC 


0009 


223 






PFDSECTOR 


0006 


236 






PFDSTAT 


0004 


328 






PFDTRACK 


0005 


235 


306 




PINDEX 


000F 








PLPT2DATA 


0028 








PLPT2STAT 


0029 








P LPT DATA 


001E 








PLPTSTAT 


001F 








PRTC 


0033 








PSELECT 


0008 


209 






PWD1797 


0004 








PZCTC1 


oooc 








PZCTC2 


0030 








PZDART 


001C 








PZDMA 


0000 


239 


333 




PZPIOl 


0008 








PZPIOIA 


000A 


155 






PZPIOIB 


000B 


157 






PZPI02 


0010 








PZPI02A 


0012 








PZPI02B 


0013 








PZPI03 


0024 








PZPI03A 


0026 








PZPI03B 


0027 








PZSIOl 


0028 








PZSI02 


002C 








READID 


01E1 


298 


301 


3311 


READIDBLOCK 


02AB 


332 


4171 


430 


READMSG 


0218 


189 


3661 


369 


RESTORE 


01D3 


303 


3181 




RETRYOPERATION 


010F 


2121 


259 




RWCOMMON 


00ED 


191 


1981 




SAMETRACK 


0139 


223 


2341 




SELECTMASK 


0212 


208 


215 


3551 


SELECTTABLE 


0216 


207 


3611 




SPINLOOP 


0133 


2291 


232 




STEP OUT 


01CE 


300 


3141 




TRANS 


00A4 


62 


63 


79 


UC1 


0202 


344 


3461 




UCONINECHO 


01F5 


284 


3431 


345 


WAITIREQ 


01D7 


3261 


327 




WRITEMSG 


021F 


194 


3671 




ZDMADIRECTION 


02A8 


204 


4101 




ZDMADMA 


029F 


205 


4031 




? CON IN 


0000 


32 


345 


347 


7CONO 


0000 


32 


348 




7CONST 


0000 


33 


344 




7PDEC 


0000 


30 






7PDERR 


0000 


31 


269 




7PMSG 


0000 


29 


271 


280 


7WBOOT 


0000 


28 


290 




9ADRV 


0000 


18 
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@DBNK 


0000 


20 


245 


?DMA 


0000 


19 


205 


@ERMDE 


0000 


24 


263 


SRDRV 


0000 


IB 


206 


eSECT 


0000 


19 


236 


3TRK 


0000 


19 


219 



Listing 1-4. (continued) 



1.5 Bank and Move Module for CP/M 3 Linked BIOS 

The MOVE. ASM module performs memory-to-memory moves and bank 
selects. 



10 






11 






12 


0000 


C9 


13 






14 






15 


0001 


EB 


16 






17 


0002+EDBO 


18 


0004 


EB 


19 


0005 


C9 


20 






21 






22 






23 


0006 


C5 


24 


0007 


171717E6H 


25 


oooc 


47 


26 


000D 


DB25 


27 


000F 


E6E7B0 


28 


0012 


D325 


29 


0014 


CI 


30 


0015 


C9 


31 






32 






33 






34 


0016 





BC 


0000 


DE 


0002 


HL 


0004 


IX 


0004 


IY 


0004 


PBANKSELECT 


0025 


PBAUDCON1 


OOOC 


PBAUDCON2 


0030 


PBAUDCON34 


■ J 0031 


PBAUDLPT1 


O0OE 


PBAUDLPT2 


0032 


PBOOT 


0014 


PCENTDATA 


0011 


PCENTSTAT 


0010 


PCON2DATA 


002C 


PCON2STAT 


002D 


PCON3DATA 


002E 


PCON3STAT 


002F 


PCON4DATA 


002A 


PCON4STAT 


002B 


PCONFIGURATION 


0024 


P CRT DATA 


001C 



title 'bank & move module for CP/M3 linked BIOS' 
cseg 



public ?move,?xmove ,7bank 
extrn ?cbnk 



maclib z80 
maclib ports 



xchg 
ldir 



xchg 
ret 



; ALTOS can't perform interbank moves 



; we are passed source in DE and dest in PL 
; use Z80 block move instruction 
0EDH,OBOH 

; need next addresses in same regs 



push b 

ral 1 ral ! ral 1 ani 18h 

mov b,a 

in p$bankselect 

ani 0E7h I ora b 

out p$bankselect 

pop b 

ret 



; by exiting through bank select 

; save register b for temp 

j isolate bank in proper bit position 

; save in reg B 

; get old memory control byte 

; mask out old and merge in new 

; put new memory control byte 

; restore register b 



128 bytes at a time 
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PCRTSTAT 


001D 






PFDCKND 


0004 






PFDDATA 


0007 






PFDINT 


0008 






PFDMISC 


0009 






PFDSECTOR 


0006 






PFDSTAT 


0004 






PFDTRACK 


0005 






PINDEX 


000F 






PLPT2DATA 


0028 






PLPT2STAT 


0029 






P LPT DATA 


001E 






PLPTSTAT 


001F 






PRTC 


0033 






PSELECT 


0008 






PWD1797 


0004 






PZCTC1 


oooc 






PZCTC2 


0030 






PZDART 


001C 






PZDHA 


0000 






PZPIOl 


0008 






PZPI01A 


000A 






PZPIOIB 


000B 






PZPI02 


0010 






PZPI02A 


0012 






PZPI02B 


0013 






PZPI03 


0024 






PZPI03A 


0026 






PZPI03B 


0027 






PZSIOl 


0028 






PZSI02 


002C 






7BANK 


0006 


5 


221 


7M0VE 


0001 


5 


141 


7XMOVE 


0000 


5 


lit 


8CBNK 


0000 


6 





Listing 1-5. (continued) 



1.6 I/O Port Addresses for Z80 Chip-based System: PORTS. LIB 

This listing is the PORTS. LIB file on your distribution 
diskette. It contains the port addresses for the Z80 chip-based 
system with a Western Digital 1797 Floppy Disk Controller. 



T /0 Port addresses for Z80 chip set based system with wdl797 FDC 



! 


chip bases 


pSzdraa 


equ 


p$wdl797 


equ 4 


p$zpiol 


equ 8 


p$zctcl 


equ 12 


p$zpio2 


equ 16 


p$boot 


equ 20 > OUT < 


p$zdart 


equ 28 % const 


p$zpio3 


equ 36 


p$zsiol 


equ 40 


p$zsio2 


equ 44 


p$zctc2 


equ 48 


; 


diskette controller < 


p$fdcmnd 


equ p$wdl797+0 


p$fdstat 


equ p$wdl797+0 


p$fdtrack 


equ p$wdl797+l 


p$fdsector equ p$w<51797+2 


p$fddata 


equ p$wdl797+3 



; OUT disables boot EPROM 
( console 1 and printer 1 



; parallel I/O 1 
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p$select equ pSzplol+0 

p$fdint e,qu p$zpiol+0 

p$fdmisc equ p$zpiol+l 

p$zpiola equ pSzpiol+2 

p$zpiolb equ pSzplol+3 

; counter timer chip 1 

p$baudconl equ p$zctcl+0 
p$baudlptl equ p$zctcl+2 
p$index equ p$zctcl+3 

; parallel I/O 2, Centronics printer interface 

p$centSstat equ p$zpio2+0 

p$cent$data equ p$zpio2+l 

p$zpio2a equ p$zpio2+2 

p$zpio2b equ p$zpio2+3 

; dual asynch rcvr/xmtr, console and serial printer ports 

p$crt$data equ pSzdart+0 

p$crt$stat equ p$zdart+l 

p$lpt$data equ pSzdart+2 

p$lpt$stat equ p$zdart+3 

; Third Parallel I/O device 

p$conf iguration equ p$zpio3+0 
p$bankselect equ p$zpio3+l 
p$zpio3a equ p$zpio3+2 
p$zpio3b equ p$zpio3+3 

; Serial I/O device 1, printer 2 and console 4 

p$lpt2data equ p$zsiol+0 

p$lpt2stat equ pSzsiol+1 

p$con4data equ p$zsioH-2 

p$con4stat equ p$zsiol+3 

; Serial I/O device 2, console 2 and 3 

p$con2data equ p$zsio2+0 

p$con2stat equ p$zsio2+l 

p$con3data equ p$zsio2+2 

p$con3stat equ p$zsio2+3 

; second Counter Timer Circuit 

p$baudcon2 equ p$zctc2+0 

p$baudcon34 equ p$zctc2+l 

p$baudlpt2 equ p$zctc2+2 

p$rtc equ p$zctc2+3 

Listing 1-6. (continued) 
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1.7 Sample Submit File for ASC 8000-15 System 

Digital Research used this SUBMIT file to build the sample 
BIOS. 

;Submit file to build sample BIOS for ACS 8000-15 single-density system 

rmac bioskrnl 

rmac boot 

rmac move 

rmac chario 

rmac drvtbl 

rmac fdl797sd 

rmac scb 

link bnkbios3[b,q] =bioskr nl, boot , move , char io, drvtbl, fdl797sd, scb 

gencpm 

Listing 1-7. Sample Submit File for ASC 8000-15 System 

End of Appendix I 
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Public 










Module 


Entry 




Input 




Return 


Name 


Point 


Function 


Parameter 




Value 


BIOSKRNL 














7PMSG 


Print Message 


HL .points to 


msg 


none 




7PDEC 


Print Decimal 


HL*number 




none 




7PDERR 


Print BIOS Disk 
Err Msg Header 


none 




none 


CHARIO 














7CINIT 


Char Dev Init 


C=Phys Dev I 
Dev Parms in 


eCTBL 


none 




7CIST 


Char Inp Dev St 


B«Phys Dev 1 




A-00 If no input 
A»0FFH if input 
char available 




7C0ST 


Char Out Dev St 


B=Phys Dev I 




A=00 if output 

busy 
A=0FFH if output 

ready 




7CI 


Char Dev Input 


B»Phys Dev I 




A=next available 
input char 




7 CO 


Char Dev Output 


B»Phys Dev I 
C=Input Char 







Memory to Memory BC=byte count DE.HL point to 
Move DE=start source adr next bytes 

HL=start dest adr after move 



7XM0VE 


Set Banks for 


B"Source Bank 


BC,DE,HL are 




Extended Move 


C=Dest Bank 


unchanged 


7BANK 


Select Bank 


A=Bank Number 


All unchanged 


7INIT 


System Init 


none 


none 


7LDCCP 


Load CCP 


none 


none 


7RLCCP 


Reload CCP 


none 


none 


7TIME 


Get/Set Time 


C=000H if get 
C-OFFH if set 


none 



Listing J-l. Public Entry Points for CP/M 3 Sample BIOS Modules 
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Public Data Items in CP/M 3 Sample BIOS Modules 



Table K-l. Public Data Items 



Module 


Public 






Name 


Data 


Description 




BIOSKRNL 










@ADRV 


Absolute Logical Drive 


Code 




@RDRV 


Relative logical drive 


code (UNIT) 




@TRK 


Track Number 






@SECT 


Sector Address 






@DMA 


DMA Address 






@DBNK 


Bank for Disk I/O 






@CNT 


Multi-sector Count 






@CBNK 


Current CPU Bank 




CHARIO 










@CTBL 


Character Device Table 




DRVTBL 










@DTBL 


Drive Table 





End of Appendix K 
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CP/M 3 BIOS Function Summary 





Table L-l 


BIOS Function 


Jump Table Summary 


No. 


Function 


Input 


Output 





BOOT 


None 


None 


1 


WBOOT 


None 


None 


2 


CONST 


None 


A=0FFH if ready 
A=00H if not ready 


3 


CONIN 


None 


A=Con Char 


4 


CONOUT 


C=Con Char 


None 


5 


LIST 


C=Char 


None 


6 


AUXOUT 


C=Char 


None 


7 


AUXIN 


None 


A=Char 


8 


HOME 


None 


None 


9 


SELDSK 


C=Drive 0-15 


HL=DPH addr 






E=Init Sel Flag HL=000H if invalid dr. 


10 


SETTRK 


BC=Track No 


None 


11 


SETSEC 


BC=Sector No 


None 


12 


SETDMA 


BC=.DMA 


None 


13 


READ 


None 


A=00H if no Err 

A=01H if Non-recov Err 

A=0FFH if media changed 


14 


WRITE 


C=Deblk Codes 


A=00H if no Err 
A=01H if Phys Err 
A=02H if Dsk is R/O 
A=0FFH if media changed 


15 


LISTST 


None 


A=00H if not ready 
A=0FFH if ready 


16 


SECTRN 


BC=Log Sect No 


HL=Phys Sect No 






DE=Trans Tbl Adr 


17 


CONOST 


None 


A=00H if not ready 
A=0FFH if ready 


18 


AUXIST 


None 


A=00H if not ready 
A=0FFH if ready 


19 


AUXOST 


None 


A=00H if not ready 
A=0FFH if ready 


20 


DEVTBL 


None 


HL=Chrtbl addr 


21 


DEVINI 


C=Dev No 0-15 


None 


22 


DRVTBL 


None 


HL=Drv Tbl addr 
HL=0FFFFH 
HL=0FFFEH 
HL=0FFFDH 


23 


MULTIO 


C=Mult Sec Cnt 


None 


24 


FLUSH 


None 


A=000H if no err 
A=001H if phys err 
A=002H if disk R/O 


25 


MOVE 


HL=Dest Adr 


HL & DE point to next 






DE=Source Adr 


bytes following MOVE 
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Table L-l. (continued) 


No. 


Function 


Input 


Output 


26 


TIME 


C=Get/Set Flag 


None 


27 


SELMEM 


A=Mem Bank 


None 


28 


SETBNK 


A=Mem Bank 


None 


29 


XMOVE 


B=Dest Bank 
C=Source Bank 
BC=Count 


None 


30 


USERF 


Reserved for System Implementor 


31 


RESERV1 


Reserved for Future Use 


32 


RESERV2 


Reserved for Future Use 



End of Appendix L 
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Index 



?, 73 
6. 73 



absolute drive code, 76 
allocation vector, 38 
application programs, 

memory for , 1 
assembly-time arithmetic, 27 
AUTO DISPLAY parameter , 88 
AUTO parameter , 88 
auto-density support, 109 
AUXIN, 19, 56 
AUXIST, 57 
AUXOST, 58 
AUXOUT, 19, 56 



B 



$B, 101 

Bank 0, 5, 6 

Bank 1, 6 

BANK field, 46 

bank switching, 6 

bank-switched memory, 4 

block moves and memory 
selects, 15 

requirements, 1, 8 
banked BIOS 

assembling, 69 

linking, 69 

preparing, 69 
banked system, 

allocation vector, 39 

BANK field, 46 

BCB data structures, 46 

BDOS and BIOS, in common 
memory, 9 

BDOS and BIOS, in Bank 0, 9 

buffer control block, 44 

common memory, 34 

with Bank 1 enabled, 6 
Basic Disk Operating System; 

see BDOS 
baud rates, 

for serial devices, 79 



BDOS, 2, 15 

calls to BIOS, 21 

error messages in foreign 
language, 32 

flags, 3 

function 44, 52 

function 49, 3 

function 50, 16 
Binary Coded Decimal (BCD) 

format, 24 

fields, 31 
BIOS 

assembling, 69 

calls, 20 

customizing, 4, 10 

debugging; see debugging, 103 

entry points, 64 

error message header, 84 

functions, 52, 55-66 

jump vector 

linking, 69 

media flag , 107, 108 

modules, 86 

public names, 77 

routines, 2 

subroutine entry points, 84 

subroutines, 17 
BIOSKRNL.ASM, 71-73 

public utility subroutines, 76 
block , 

defined, 41 

disk transfers, 20 

mask, 42 

moves, 15 

shift factor, 42 

size restriction, 41 
block transfers 

memory-to-memory, 24 
blocking logical records, 23 
blocking/deblocking, 64 
@BNKBF, 18 
BOOT, 17-18, 51 

entry point, 100 
boot loader, 102 
BOOT module, 

entry points, 77 
BOOT. ASM, 71 
booting CP/M 3, 102 
buffer control block, 44 
built-in commands, 2 
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CCP, 

flags, 3 

loading into TPA, 78 
CCP.COM, 13, 18 
character device table 
(@CTBL), 74 

device name fields, 78 
character devices 

interfacing, 78 

labels, 80 

logical to physical 
redirection, 74 
character I/O, 19 

interface routines, 74 

redirection, 78 
character table, 32 
CHARIO module, 74, 78 
CHARIO.ASM, 71 
checksum vector, 38 
CHRTBL, 32, 78 
clock support, 24 
cold boot 

loader program, 12 

process, 12 
cold BOOT routine, 13 

passpoint, 105 

setting passpoint, 105 
cold start, 11, 101 

loader, 15, 19, 101 
common memory, 67 
common base, 13 
communications hardware, 11 
CONIN, 2, 17, 19, 55 
CONOST, 57 
CONOUT, 17, 19, 55 
Console Command Processor 

(CCP), 2 
console output, 11 
CONST, 17, 55 
COPYSYS utility, 98, 102 
counter/timer chip, 24 
CP/M 2 BIOS 

modification, 111 

converting to CP/M 3, 15 
CP/M 3 

BIOS functions, 111 

customizing hardware, 11 

loading into memory, 12 
CPM3.SYS file, 1, 11, 19 

format, 115 

loading into memory, 98 
CPMLDR.COM, 5, 11, 19, 98-100 

as transient program, 99 



sign-on message, 101 

BDOS, 11 

BIOS, 11 
@CTBL, 74, 78 
CTRL-Z (1AH) , 19, 54 



data record 

buffers, 24, 93 

caching, 23 
data structures, 

in common memory, 67 
data tracks, 10 
@DATE, 24 
DDT, 101 

deblocking logical records, 23 
debugging 

BIOS, 103 

session for nonbanked 
BIOS, 103 

with SID, 103 
default value, 

with question mark, 88 
device name format, 78 
DEVICE utility, 20, 32, 74 
DEVINI entry point, 52 
DEVTBL entry point, 52 
diagnostic capabilities, 24 
Direct Memory Access (DMA) 

address, 20 
directory 

buffers, 92 

caching, 23 

entries 

maximum size, 1 

hash tables, 5 
directory hashing 

as GENCPM option, 39 

disabling, 39 
directory search 

speeding, 23 
disk 

accesses, 18 

compatibility, 10 

density, automatically 
determined, 74 

double density, 42 

drives, 107 

I/O, 20, 71 

logical floppy or hard, 1 

number supported, 1 

physical sector size, 43 

reformatting, 42 

organization, 10 
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parameter block, 23, 34, 
37, 48 
disk parameter block 

fields, 40 

format, 40 
disk parameter header, 36, 47 

fields , 37 

format, 36 
disk record buffers, 5 
DMA controller, 9 
double-density disks, 42 
DPB macro, 48 
DPH macro, 47 
drive code, 

absolute, 76 

relative, 76 
drive table, 47 
DRVTBL.ASM, 53, 71, 74, 81 
@DTBL, 74 
DTBL macro, 47 
dynamic disk definition table. 



E 



end-of-file condition, 19, 54 
entry points, 

BIOS subroutine, 84 

BOOT, 51 

BOOT module, 51, 77 

DEVTBL, 52 

DEVINI, 52 

MOVE module, 86 

WBOOT, 52 
equates, 

absolute external, 27 
error 

condition, 23, 24 

in multisector transfer, 63 

nonrecoverable, 84 
error messages, 

extended, 30 

in foreign language, 32 

short, 30 
Extended Disk Parameter Header 
(XDPH) , 71, 81 

fields , 83 

format, 82 
external names, 73 
external reference, 73 



random access, 1 

sequential access, 1 
flag, 

global system, 30 

media, 37 
FLUSH, 17, 64 



G command, 105 

GENCPM utility, 5, 11, 36, 46 
and AUTO DISPLAY parameter, 
command input, 87 
directory hashing, 39 
in banked system, 87 
in nonbanked system, 87 

global system flag, 30 

global variables, 76 



H 



59 



file format, 

CPM3.SYS, 115 
file, 



handshaking 

polled, 57, 58 
hardware 

environment, 10 

initialization, 77 

requirements, 1 

special DMA, 65 
hash table, 9, 23, 39, 107 
hardware environment, 

nonbanked system, 11 
HOME, 17, 58 
@HOUR, 24 



I/O 

character, 19 

devices, 11 

disk, 20 

multiple sector, 22 

redirection, 20 

redirection bit vectors, 54 
IBM 3740 disk, 10 
initialization, 

basic system^ 51 

cold start, 11 

hardware, 51, 77 

Page Zero, 51 

system tracks , 102 
interactive console, 19 
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JMP, 

BDOS, 18 

WBOOT, 18 
jump 

address, 16 

instructions, 50 

table, 2 

vector , 77 



L option, 100 
labels, of SCB, 27 
LDRBIOS.ASM, assembling, 100 
LINK-80, 69, 73 

L option, 100 
linking modules into BIOS, 86 
LIST, 19, 56 
LISTST, 57 
loader file, 11 
logical character devices, 

combinations, 54 
logical 

devices, 20 

records, 3 



H 



macro definitions, 46 

maximum size directory entries, 1 

media 

change, 107 

flag, 37, 108 

removable, 107 
media type, automatically 

determined, 74 
memory 

bank-switched; see 
bank-switched memory 

contiguous, 11 

for application programs, 1 

image, 13 

management functions, 24 

map, 11 

nonbank-switched; see 
nonbank-switched memory 

segment, 91 

selects, 15 
memory organization, 

banked, 5 

general, 3 

nonbanked, 7-9 
memory regions, page aligned, 4 



memory requirements, 

banked, 8 

nonbanked, 9 
memory-to-memory move, 86 
@MIN, 24 

modifying CP/M 2 BIOS, 111 
MOVE. ASM module, 24, 65, 71 

entry points, 86 
MULTIO, 17, 20, 63 
multiple disk formats, 109 
multisector count, 30 
@MXTPA, 18 



N 



nonbank-switched memory, 

block moves and memory 
selects, 15 

requirements, 1 
nonbanked BIOS, 

assembling, 69 

debugging session, 103 

linking, 69 
nonbanked memory, 4 
nonbanked system, 

buffer control block, 44 

modifying BIOSKRNL.ASM, 71 
nonrecoverable error, 84 



OEM subroutines, 16 

OFF field, 43 

OPEN, 18 

operating system bank, 9 

operating system modules 

banked, 5 

resident, 5 



P command, 105 
page boundary, 4 
Page Zero, 18 
passpoints, 

cold BOOT routine, 105 

in BIOS, 104 
QPDERR subroutine, 84 
peripheral devices, 

reassigning, 20 
permanent drives, 107 
physical 

devices, 20 

I/O, 2 

record mask, 44 
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record shift factor, 43 

sectors, 3, 20 
plotters, 11 
primitive functions, 

hardware-dependent, 2 
printers, 11 

Program Loader Module, 2 
PROM loader, 13 
public names, 54, 77 
public symbols, 

defined in modules, 75 
public utility subroutines, 

in BIOSKRNL.ASM, 76 
public variable, 

names , 17 

predefined, 75 



question mark, 88 
question variable, 88 



r/o, 27 

r/w, 27 

Random Access Memory , 11 

READ, 17, 18, 20, 61 

real-time clock, 24 

redirection vectors, 29 

register A, 17, 20 

relative drive code, 76 

removable drives, 107 

Resident System Extension (RSX) 

modules, 9 
retry routine, 84 
RMAC, 69, 73, 99 
rotational latency, 20 



SCB see System Control Block 

SCB.ASM file, 17, 27-28, 71 
error mode variable, 24 

@SEC, 24 

SECTRN, 17, 62 

SELDSK, 17, 20, 59, 74~ 
routine, 109 

SELMEM, 24, 66 

sequential file input, 11 

serial devices, 
baud rates, 79 

SETBNK, 24, 66 

SETDMA, 17, 20, 60 

SETSEC, 17, 60 



SETTRK, 17, 59 
SID, 104 

sign-on message, 101 
skew factor, 

standard CP/M disk, 6 2 
SKEW macro, 48 
skew table 

address, 62 

SKEW macro, 48 
space allocation, 6 
subroutine names, 17 
symbols, 

public; see public symbols 
system bank, 6 
System Control Block (SCB) , 27 

fields, 29 
system disk organization, 10 
system initialization, 1, 18 
system loader, 1 
System Page Relocatable 

(.SPR) files, 4 
system parameters, critical, 3 
system tracks, 102 



TIME, 17, 67 

time of day function, 24 

TPA, 32 

tracing routines, 105 

Transient Program Area; see TPA 

transient programs, 18 

bank, 6 
translation table, 37 



variables 

global; see global variables 
public; see public variables 

vector , 

allocation, 38 

checksum, 38 

I/O redirection bit, 54 

W 

Warm BOOT routine, 3 
WBOOT, 17-18 

entry point, 52 
WRITE, 17, 20, 61 



XDPH, 82 

XMOVE, 24, 65, 66 
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Reader Comment Form 

We welcome your comments and suggestions. They help us provide you with better 
product documentation. 

Date Manual Title Edition 

1. What sections of this manual are especially helpful? 



2. What suggestions do you have for improving this manual? What information 
is missing or incomplete? Where are examples needed? 



3. Did you find errors in this manual? (Specify section and page number.) 
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Following are corrections to the CP/M Plus™(CP/M® Version 3) 
Operating System System Guide . 

Page 82 

Section 4.7.3 Extended Disk Parameter Headers (XDPHs) 

Figure 4-1., XDPH Format, is incorrect. The Media Flag shown 
at Address XDPH+10 should be in the High Byte column, and should 
be in the Low Byte column. 

Page 86 

Section 4.9 Linking Modules into the BIOS 

The option shown in the second link command example is 
incorrect. The command line should read as follows: 

LINK BI0S3[osl=BI0S,SCB, BOOT, CHARIO, MOVE, DRVTBL,<disk modules> 
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